src/cairo/README

   1 This is a standalone PHP extension created using CodeGen_PECL 1.1.2
   2
   3 HACKING
   4 =======
   5
   6 There are two ways to modify an extension created using CodeGen_PECL:
   7
   8 1) you can modify the generated code as with any other PHP extension
   9
  10 2) you can add custom code to the CodeGen_PECL XML source and re-run pecl-gen
  11
  12 The 2nd approach may look a bit complicated but you have be aware that any
  13 manual changes to the generated code will be lost if you ever change the
  14 XML specs and re-run PECL-Gen. All changes done before have to be applied
  15 to the newly generated code again.
  16 Adding code snippets to the XML source itself on the other hand may be a
  17 bit more complicated but this way your custom code will always be in the
  18 generated code no matter how often you rerun CodeGen_PECL.
  19
  20
  21 BUILDING ON UNIX etc.
  22 =====================
  23
  24 To compile your new extension, you will have to execute the following steps:
  25
  26 1.  $ ./phpize
  27 2.  $ ./configure [--enable--phpCairo]
  28 3.  $ make
  29 4.  $ make test
  30 5.  $ [sudo] make install
  31
  32
  33
  34 BUILDING ON WINDOWS
  35 ===================
  36
  37 The extension provides the VisualStudio V6 project file
  38
  39   phpCairo.dsp
  40 To compile the extension you open this file using VisualStudio,
  41 select the apropriate configuration for your installation
  42 (either "Release_TS" or "Debug_TS") and create "php_phpCairo.dll"
  43
  44 After successfull compilation you have to copy the newly
  45 created "phpCairo.dll" to the PHP
  46 extension directory (default: C:\PHP\extensions).
  47
  48
  49 TESTING
  50 =======
  51
  52 You can now load the extension using a php.ini directive
  53
  54   extension="phpCairo.[so|dll]"
  55
  56 or load it at runtime using the dl() function
  57
  58   dl("phpCairo.[so|dll]");
  59
  60 The extension should now be available, you can test this
  61 using the extension_loaded() function:
  62
  63   if (extension_loaded("phpCairo"))
  64     echo "phpCairo loaded :)";
  65   else
  66     echo "something is wrong :(";
  67
  68 The extension will also add its own block to the output
  69 of phpinfo();
  70