svn: /phpdoc/ doc-base/trunk/entities/global.ent en/trunk/reference/wincache/book.xml en/trunk/reference/wincache/win32build.xml
| From: | Ruslan Yakushev | Date: | Fri, 13 Nov 2009 06:43:13 +0000 |
| Subject: | svn: /phpdoc/ doc-base/trunk/entities/global.ent en/trunk/reference/wincache/book.xml en/trunk/reference/wincache/win32build.xml | ||
| Groups: | php.doc.cvs | ||
| Request: | Send a blank email to doc-cvs+get-5335@lists.php.net to get a copy of this message | ||
ruslany Fri, 13 Nov 2009 06:43:13 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=290663
Log:
Added section about how to build WinCache on Windows.
Changed paths:
U phpdoc/doc-base/trunk/entities/global.ent
U phpdoc/en/trunk/reference/wincache/book.xml
A phpdoc/en/trunk/reference/wincache/win32build.xml
Modified: phpdoc/doc-base/trunk/entities/global.ent
===================================================================
--- phpdoc/doc-base/trunk/entities/global.ent 2009-11-13 06:15:26 UTC (rev 290662)
+++ phpdoc/doc-base/trunk/entities/global.ent 2009-11-13 06:43:13 UTC (rev 290663)
@@ -374,6 +374,7 @@
<!ENTITY url.php.dochowto "http://doc.php.net/php/dochowto/">
<!ENTITY url.php.downloads "http://www.php.net/downloads.php">
<!ENTITY url.php.win.downloads "http://windows.php.net/download/">
+<!ENTITY url.php.win.build "http://wiki.php.net/internals/windows/stepbystepbuild">
<!ENTITY url.php.echm "http://www.php.net/docs-echm.php">
<!ENTITY url.php.gtk "http://gtk.php.net/">
<!ENTITY url.php.hosts "http://www.php.net/links.php#hosts">
Modified: phpdoc/en/trunk/reference/wincache/book.xml
===================================================================
--- phpdoc/en/trunk/reference/wincache/book.xml 2009-11-13 06:15:26 UTC (rev 290662)
+++ phpdoc/en/trunk/reference/wincache/book.xml 2009-11-13 06:43:13 UTC (rev 290663)
@@ -59,6 +59,7 @@
&reference.wincache.setup;
&reference.wincache.constants;
&reference.wincache.reference;
+ &reference.wincache.win32build;
</book>
Added: phpdoc/en/trunk/reference/wincache/win32build.xml
===================================================================
--- phpdoc/en/trunk/reference/wincache/win32build.xml (rev 0)
+++ phpdoc/en/trunk/reference/wincache/win32build.xml 2009-11-13 06:43:13 UTC (rev 290663)
@@ -0,0 +1,136 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision: 1 $ -->
+<appendix xml:id="wincache.win32build" xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink">
+ <title>Building for Windows</title>
+ <section xml:id="wincache.win32build.prereq">
+ <title>Prerequisites</title>
+ <para>
+ Building WinCache extension will require:
+ </para>
+ <orderedlist spacing="compact">
+ <listitem>
+ <simpara>PHP source code</simpara>
+ </listitem>
+ <listitem>
+ <simpara>PHP build environment</simpara>
+ </listitem>
+ <listitem>
+ <simpara>WinCache source code</simpara>
+ </listitem>
+ </orderedlist>
+ <para>
+ For completing first two steps, follow the step-by-step guide for how
+ to <link xlink:href="&url.php.win.build;">build PHP on
Windows</link>.
+ </para>
+ <para>
+ For getting the WinCache source code follow the instructions described in
+ <link linkend="install.pecl.downloads">Downloading PECL
extensions</link>.
+ </para>
+ </section>
+ <section xml:id="wincache.win32build.building">
+ <title>Compiling and building</title>
+ <para>
+ The following steps describe how to compile and build WinCache on Windows OS:
+ </para>
+ <procedure>
+ <step>
+ <simpara>Open a command prompt which is used to build PHP</simpara>
+ </step>
+ <step>
+ <simpara>Go to the root folder where PHP sources are present</simpara>
+ </step>
+ <step>
+ <para>
+ Run the command:
+ <programlisting role="cmd">
+<![CDATA[
+cscript.exe win32\build\buildconf.js
+]]>
+ </programlisting>
+ </para>
+ </step>
+ <step>
+ <para>
+ Run the command:
+ <programlisting role="cmd">
+<![CDATA[
+configure.bat --help
+]]>
+ </programlisting>
+ The output will contain a new flag <literal>--enable-wincache</literal>.
+ </para>
+ </step>
+ <step>
+ <para>
+ Run the command:
+ <programlisting role="cmd">
+<![CDATA[
+configure.js [all options used to build PHP] --enable-wincache
+]]>
+ </programlisting>
+ <literal>--enable-wincache</literal> is the only extra option which is
+ required to ensure that WinCache extension gets built properly.
+ This option will build WinCache and will statically link it with PHP dll.
+ To build WinCache extension as a stand-alone DLL use the option
+ <literal>--enable-wincache=shared</literal>.
+ </para>
+ </step>
+ <step>
+ <para>
+ Run the command:
+ <programlisting role="cmd">
+<![CDATA[
+nmake
+]]>
+ </programlisting>
+ </para>
+ </step>
+ </procedure>
+ </section>
+ <section xml:id="wincache.win32build.verify">
+ <title>Verifying the build</title>
+ <para>
+ The following steps describe how to verify that WinCache has been built correctly:
+ </para>
+ <procedure>
+ <step>
+ <simpara>
+ Go to the folder where the PHP binaries are built
+ </simpara>
+ </step>
+ <step>
+ <para>
+ Run the command:
+ <programlisting role="cmd">
+<![CDATA[
+php.exe -n -d extension=php_wincache.dll -re wincache
+]]>
+ </programlisting>
+ If WinCache has been built properly, the output of this command will
+ list the INI directives and functions supported by WinCache.
+ </para>
+ </step>
+ </procedure>
+ </section>
+</appendix>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->