Extending and embedding PHP Includes index

Cover......Page 1
Contents......Page 8
Introduction......Page 22
 Starting Up and Shutting Down......Page 30
  CLI Life Cycle......Page 34
  The Multiprocess Life Cycle......Page 35
  The Embed Life Cycle......Page 36
 Zend Thread Safety......Page 37
  Thread-Safe Data Pools......Page 38
  Agnostic Globals Access......Page 39
  Threading Even When You Don’t Have To......Page 40
  Finding a lost tsrm_ls......Page 42
 Summary......Page 43
 Data Types......Page 44
 Data Values......Page 48
 Data Creation......Page 49
 Data Storage......Page 50
 Data Retrieval......Page 52
 Data Conversion......Page 53
 Summary......Page 55
  Free the Mallocs......Page 56
  Error Handling......Page 57
  Zend Memory Manager......Page 58
 Reference Counting......Page 62
  Copy on Write......Page 63
  Change on Write......Page 64
  Separation Anxiety......Page 65
 Summary......Page 67
  *nix Tools......Page 68
  Win32 Tools......Page 69
  Performing a CVS Checkout......Page 70
  –enable-debug......Page 71
  –enable-embed......Page 72
 Compiling on Win32......Page 73
 Summary......Page 75
  Configuration File......Page 76
  Header......Page 77
  Source......Page 78
  Building Under *nix......Page 79
  Building Under Windows......Page 80
  Loading an Extension Built as a Shared Module......Page 81
  Building Static Under *nix......Page 82
 Functional Functions......Page 83
  Zend Internal Functions......Page 84
  Function Aliases......Page 85
 Summary......Page 86
 The return_value Variable......Page 88
  Wrap Your Macros Tightly......Page 90
  Is It Worth the Trouble?......Page 91
  Returning Reference Values......Page 92
 Returning Values by Reference......Page 94
  Call-time Pass-by-ref......Page 95
  Compile-time Pass-by-ref......Page 96
 Summary......Page 99
 Automatic Type Conversion with zend_parse_parameters ( )......Page 100
  Optional Parameters......Page 103
  IS_NULL Versus NULL......Page 104
 zend_get_arguments ( )......Page 105
 Arg Info and Type-hinting......Page 107
 Summary......Page 109
  Vectors......Page 110
  Linked Lists......Page 111
  Creation......Page 114
  Population......Page 115
  Recall......Page 116
  Quick Population and Recall......Page 117
  Copying and Merging......Page 118
  Iteration by Hash Apply......Page 119
  Iteration by Move Forward......Page 122
  Preserving the Internal Pointer......Page 125
  Destruction......Page 126
  Sorting, Comparing, and Going to the Extreme(s)......Page 128
  Easy Array Population......Page 130
 Summary......Page 132
 Complex Structures......Page 134
  Registering Resources......Page 135
  Destroying Resources......Page 136
  Decoding Resources......Page 137
  Forcing Destruction......Page 139
  Memory Allocation......Page 141
  Delayed Destruction......Page 143
  Long Term Registration......Page 144
  Reuse......Page 146
  Agnostic Retrieval......Page 148
 The Other refcounter......Page 149
 Summary......Page 150
 Implementing Classes......Page 152
  Declaring Class Entries......Page 154
  Defining Method Implementations......Page 155
  Constructors......Page 156
  Inheritance......Page 157
  Creating Instances......Page 158
  Accepting Instances......Page 160
  Accessing Properties......Page 161
 Summary......Page 162
  zend_class_entry......Page 164
  Declaration......Page 165
  Special Methods......Page 167
 Properties......Page 169
  Constants......Page 170
 Interfaces......Page 171
  Implementing Interfaces......Page 172
  Standard Handlers......Page 173
  Magic Methods, Part Deux......Page 176
 Summary......Page 179
 Cycles......Page 180
  Module Cycle......Page 182
  Request Cycle......Page 183
 Exposing Information Through MINFO......Page 184
 Constants......Page 186
  Declaring Extension Globals......Page 188
  Per-Thread Initializing and Shutdown......Page 189
  Accessing Extension Globals......Page 191
 Userspace Superglobals......Page 193
  Auto Global Callback......Page 194
 Summary......Page 195
 Declaring and Accessing INI Settings......Page 196
  Simple INI Settings......Page 197
  Access Levels......Page 198
  Modification Events......Page 199
  Displaying INI Settings......Page 200
  Binding to Extension Globals......Page 202
 Summary......Page 203
 Opening Streams......Page 204
  Fopen Wrappers......Page 205
  Transports......Page 207
  Directory Access......Page 210
 Accessing Streams......Page 211
  Reading Directory Entries......Page 212
  Writing......Page 213
  Seeking, Telling, and Flushing......Page 214
  Exchanging Streams for zvals......Page 216
 Static Stream Operations......Page 217
 Summary......Page 218
 PHP Streams Below the Surface......Page 220
 Wrapper Operations......Page 223
 Implementing a Wrapper......Page 224
  Inside the Implementation......Page 232
  URL Parsing......Page 233
  opendir ( )......Page 234
 Manipulation......Page 237
  rename, mkdir, and rmdir......Page 238
  stat......Page 240
 Summary......Page 241
  Setting Options......Page 242
  Retrieving Options......Page 243
  Parameters......Page 245
  The Default Context......Page 247
  Applying Existing Filters to Streams......Page 248
  Defining a Filter Implementation......Page 249
 Summary......Page 253
 Autoconf......Page 256
  Scanning for Headers......Page 257
  Testing for Functionality......Page 258
  Testing Actual Behavior......Page 259
  Configuretime Module Dependency......Page 260
  Runtime Module Dependency......Page 261
 Speaking the Windows Dialect......Page 262
 Summary......Page 264
 ext_skel......Page 266
  specfile.xml......Page 267
  About the Extension......Page 268
  Dependencies......Page 269
  Globals......Page 270
  Functions......Page 271
  Custom Code......Page 272
 Summary......Page 273
 The Embed SAPI......Page 274
 Building and Compiling a Host Application......Page 275
 Re-creating CLI by Wrapping Embed......Page 276
  Setting Initial Variables......Page 278
  Overriding INI options......Page 279
  Declaring Additional Superglobals......Page 280
 Summary......Page 281
 Calling Back into PHP......Page 282
  Alternatives to Script File Inclusion......Page 283
  Calling Userspace Functions......Page 284
 Dealing with Errors......Page 285
 Initializing PHP......Page 286
 Overriding INI_SYSTEM and INI_PERDIR Options......Page 288
  Overriding Embed Startup......Page 289
 Capturing Output......Page 290
  Buffering Output: Flush......Page 291
 Extending and Embedding at Once......Page 293
 Summary......Page 295
 Parameter Retrieval......Page 296
 Classes......Page 298
  Properties......Page 299
 Objects......Page 304
 Exceptions......Page 305
 Execution......Page 306
 INI Settings......Page 309
 Array Manipulation......Page 310
 Hash Tables......Page 311
 Resources/Lists......Page 317
 Linked Lists......Page 318
 Memory......Page 320
 Constants......Page 321
 Variables......Page 322
 Miscellaneous API Function......Page 323
 Summary......Page 324
  Output......Page 326
  Error Reporting......Page 328
  Safe Mode and Open Basedir......Page 330
  Reentrancy Safety......Page 331
 Streams API......Page 332
  Stream Creation and Destruction......Page 333
  Stream I/O......Page 335
  Stream Manipulation......Page 337
  Directory Access......Page 339
  Internal/Userspace Conversion......Page 341
  Contexts......Page 342
  Filters......Page 343
  Plainfiles and Standard I/O......Page 345
  Transports......Page 346
  Miscellaneous......Page 352
  ext/standard/base64.h......Page 353
  ext/standard/head.h......Page 354
  ext/standard/html.h......Page 355
  ext/standard/info.h......Page 356
  ext/standard/php_http.h......Page 358
  ext/standard/php_mail.h......Page 359
  ext/standard/php_string.h......Page 360
  ext/standard/php_smart_str.h......Page 365
  ext/standard/php_uuencode.h......Page 366
  ext/standard/php_var.h......Page 367
  ext/standard/md5.h......Page 368
  ext/standard/url.h......Page 369
 Summary......Page 370
 Skeletons......Page 372
  Minimal Extension......Page 373
  Extension Life Cycle Methods......Page 374
  Declaring Module Info......Page 375
  Adding Functions......Page 376
  Adding Resources......Page 377
  Calling Back Into Userspace......Page 378
  Evaluating and Executing Code......Page 379
  Testing and Linking External Libraries......Page 380
  Mapping Arrays to String Vectors......Page 381
  Accessing Streams......Page 382
  Accessing Transports......Page 383
  Computing a Message Digest......Page 384
 Summary......Page 385
  The PHP Source Tree......Page 386
  PECL as a Source of Inspiration......Page 388
  Elsewhere in the PHP CVS Repository......Page 389
  IRC......Page 390
 Summary......Page 391
 A......Page 392
 C......Page 393
 D......Page 395
 E......Page 396
 F......Page 398
 H......Page 405
 I......Page 406
 J-K-L......Page 407
 M......Page 408
 N......Page 410
 O......Page 411
 P......Page 412
 Q-R......Page 418
 S......Page 420
 U......Page 424
 V......Page 425
 X-Y-Z......Page 426