Hi, On the Windows Todo Wiki, there is one item that caught my eye [1]. So I set about updating the following page: PECL for Windows users [2].
Unfortunately, I now have to let that task for the moment and focus on my own work. I am therefore sending you what I have written so far [3] so that you can use it, improve it and maybe convert it to docbook... From what I have seen, this XML format is quite close to DocBook so that shouldn't be too much of a problem. I hope it helps. Best regards, Guillaume Rossolini [1] http://wiki.php.net/internals/windows/todo [2] http://fr3.php.net/manual/en/install.pecl.windows.php [2] http://g-rossolini.developpez.com/tmp/php-wiki/
<?xml version="1.0" encoding="ISO-8859-1"?> <document> <!-- en-tete d'article --> <entete> <rubrique>9</rubrique> <meta> <description></description> <keywords></keywords> </meta> <titre> <page>Temporary PHP Wiki add-ons</page> <article>Temporary PHP Wiki add-ons</article> </titre> <date>July18th, 2008</date> <miseajour></miseajour> <licauteur>Guillaume Rossolini</licauteur> <lictype>1</lictype> <licannee>2008</licannee> <serveur>g-rossolini HTTP</serveur> <chemin>tmp/php-wiki/</chemin> <urlhttp>http://g-rossolini.developpez.com/tmp/php-wiki/</urlhttp> <serveurftp>g-rossolini FTP</serveurftp> <cheminftp>tmp/php-wiki/</cheminftp> <urlftp>ftp://ftp-developpez.com/g-rossolini/tmp/php-wiki/</urlftp> <nopdf/> <nozip/> <pdf> <sautDePageAvantSection>0</sautDePageAvantSection> <notesBasPage>FinDocument</notesBasPage> </pdf> </entete> <!-- description des auteurs --> <authorDescriptions> <authorDescription name="Yogui"> <fullname>Guillaume Rossolini</fullname> <url>http://www.developpez.net/forums/member.php?u=30724</url> <homepage> <title>Tutoriels Web</title> <url>http://g-rossolini.developpez.com/</url> </homepage> <blog>http://blog.developpez.com/g-rossolini</blog> </authorDescription> </authorDescriptions> <!-- licence de reproduction affiché en bas de l'article --> <!-- Ne remplir cette licence que si vous n'avez pas choisi une des licence de developpez --> <licence> </licence> <!-- url où trouver le fichier inclus pour créer le cadre des renvois en fin d'article --> <reference></reference> <!-- résumé très bref de l'article affiché dans le cadre bleu en tête de page--> <synopsis> <paragraph> Contributions to the PHP Wiki, located here until I figure out how to put them on the Wiki. </paragraph> </synopsis> <!-- article proprement dit --> <summary> <section id="I"> <title>Compile PHP</title> </section> <section id="II"> <title>Install a PHP extension</title> <paragraph> On Windows, you have two ways to load a PHP extension: either compile it into PHP, or load the DLL. Loading a precompiled extension is the easiest and preferred way. </paragraph> <paragraph> To load an extension, you need to have it available as a ".dll" file on your system. All the extensions are automatically and periodically compiled by the PHP Group (see next section for the download). </paragraph> <paragraph> To compile an extension into PHP, please refer to <b>[this page]</b>. </paragraph> <paragraph> To compile a standalone extension (aka a DLL file), please refer to <b>[this page]</b>. If the DLL file is available neither with your PHP distribution nor in PECL, you may have to compile it before you can start using the extension. </paragraph> <section id="I-A"> <title>Where to find an extension?</title> <paragraph> PHP extensions are usually called "php_*.dll" (where the star represents the name of the extension) and they are located under the "PHP\ext" folder. </paragraph> <paragraph> PHP ships with the extensions most useful to the majority of developers. They are called "core" extensions. </paragraph> <paragraph> However, if you need functionnality not provided by any core extension, you may still be able to find one in PECL. The PHP Extension Community Library (PECL) is a repository for PHP Extensions, providing a directory of all known extensions and hosting facilities for downloading and development of PHP extensions. </paragraph> <paragraph> If you have developped an extension for your own uses, you might want to think about hosting it on PECL so that others with the same needs can benefit from your time. A nice side effect is that you give them a good chance to give you feedback, (hopefully) thanks, bug reports and even fixes/patches. Before you submit your extension for hosting on PECL, please read <b>[this page]</b>. </paragraph> </section> <section id="I-B"> <title>Which extension to download?</title> <liste titre="Many times, you will find several versions of each DLL:"> <element>Different version numbers (at least the first two numbers should match);</element> <element>Different thread safety settings;</element> <element>Different processor settings (x86, 64 bits...);</element> <element>Different debugging settings;</element> <element><i>etc</i>.</element> </liste> <paragraph> You should keep in mind that your extension settings should match <b>all</b> the settings of the PHP executable you are using. The following PHP script will tell you all about your PHP settings: </paragraph> <code langage="php"><![CDATA[<?php phpinfo();]]></code> <paragraph> </paragraph> <paragraph> Or from the command line, run: </paragraph> <code langage="other"><![CDATA[drive:\\path\to\php\executable\php.exe -i]]></code> </section> <section id="I-C"> <title>Load an extension</title> <paragraph> The most common way to load a PHP extension is to include it in your <i>php.ini</i> configuration file. Please note that many extensions are already present in your php.ini and that you only need to remove the semicolon to activate them. </paragraph> <code langage="ini" titre="Inactive extension"><![CDATA[;extension=php_extname.dll]]></code> <code langage="ini" titre="Active extension"><![CDATA[extension=php_extname.dll]]></code> <paragraph> </paragraph> <paragraph> However, some webservers are confusing because they do not use the php.ini located alongside your PHP executable. To find out where your actual php.ini resides, look for its path in phpinfo(). The path we are looking for is called "Loaded configuration file": </paragraph> <tableau width="80%" border="1"> <ligne> <colonne>Configuration File (php.ini) Path</colonne> <colonne>C:\WINDOWS</colonne> </ligne> <ligne> <colonne>Loaded Configuration File</colonne> <colonne>C:\Program Files\PHP\5.2\php.ini</colonne> </ligne> </tableau> <paragraph> </paragraph> <paragraph> After activating an extension, save php.ini, restart the webserver and check phpinfo() again. The new extension should now have its own section. </paragraph> </section> <section id="I-D"> <title>Resolving problems</title> <paragraph> If the extension does not appear in phpinfo(), you should check your logs to learn where the problem comes from. </paragraph> <paragraph> If you are using PHP from the command line (CLI), the extension loading error can be read directly on screen. </paragraph> <paragraph> If you are using PHP with a webserver, the location and format of the logs vary depending on your software. Please read your webserver documentation to locate the logs, as it does not have anything to do with PHP itself. </paragraph> <paragraph> Common problems are the location of the DLL, the value of the "extension_dir" setting inside php.ini and compile-time setting mismatches. </paragraph> <paragraph> If the problem lies in a compile-time setting mismatch, you probably didn't download the right DLL. Try downloading again the extension with the right settings. Again, phpinfo() can be of great help. </paragraph> </section> </section> </summary> </document>