archived-web-php/svn.php

<?php
// $Id$
$_SERVER['BASE_PAGE'] = 'svn.php';
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/prepend.inc';
$SIDEBAR_DATA = '
<h3>What is SVN?</h3>
<p>
 You can find more information about SVN, and
 download clients for most major platforms, at
 <a href="http://subversion.tigris.org">the official SVN site</a>.
</p>


<h3>Contribute</h3>
<p>
 If you would like to join PHP development or would like to
 contribute to the PHP documentation, contact the relevant
 group. You will need <a href="/svn-php.php">your own SVN account</a>
 to contribute.
</p>

<h3>Source and binary snapshots</h3>
<p>
 You may also be interested in a PHP snapshot, see
 <a href="http://snaps.php.net/">snaps.php.net</a>.
 Compiled snapshots for Windows users are also included.
</p>
';
site_header("SVN Access");
?>

<h1>SVN Access</h1>

<p>
 If you wish to get the latest PHP source tree, you can obtain it
 through SVN. You should be warned that the SVN version
 is a development version, and as such, is often unstable, and may
 not even compile properly. The advantage of using SVN, though,
 is that you can get the latest fixes and updates, without having
 to wait for the official releases.
</p>

<p>
 PHP uses an advanced configuration system that requires you to have
 the following tools. re2c is only necessary for developers and can be found
 <a href="http://re2c.org">here</a>.
 All other utilities can be obtained from
 <a href="ftp://ftp.gnu.org/pub/gnu/">the GNU FTP site</a>.
</p>

<ul>
 <li><i>autoconf</i>: 2.13</li>
 <li><i>automake</i>: 1.4+</li>
 <li><i>libtool</i>: 1.4.x+ (except 1.4.2)</li>
 <li><i>bison</i>: 1.28, 1.35, 1.75, 2.0 or higher</li>
 <li><i>flex (PHP 5.2 and earlier)</i>: 2.5.4 (<strong>not higher</strong>)</li>
 <li><i>re2c</i>: 0.13.4+</li>
</ul>

<p>
 If you're experiencing problems, see also the section on
 <a href="#buildconf_fail">buildconf failures</a>.
</p>

<h2>Steps for using PHP from SVN</h2>
<ol>

 <li>
  Obtain the latest PHP source from SVN. There is a single <i>php-src</i>
  directory that contains all PHP branches and tags. To get PHP from SVN,
  use the <i>"svn checkout http://svn.php.net/repository/php/php-src/branches/BRANCH"</i> notation. To checkout the
  latest, consider the following SVN commands:<br /><br />
  <strong>PHP 5.2</strong>:
  <code>svn checkout http://svn.php.net/repository/php/php-src/branches/PHP_5_2 php-src-5.2</code>
  <br />
  <strong>PHP 5.3</strong>:
  <code>svn checkout http://svn.php.net/repository/php/php-src/branches/PHP_5_3 php-src-5.3</code>
  <br />
  <strong>PHP 6</strong>:
  <code>svn checkout http://svn.php.net/repository/php/php-src/trunk php-src</code>
  <br /><br />
  The branch names can also be used for SVN diff and merge operations.
 </li>

 <li>
  Make sure you have autoconf 2.13 or newer, automake 1.4 or newer and libtool
  1.4.
  <div class="tip" style="margin: 10px 0 10px 20px;">
   <p>Note that certain combinations of autoconf, automake and libtool may not
   work when used together. See <a href="#buildconf_fail">below</a> for
   details.<br />
   Also, certain versions of autoconf may generate warnings of <code>AC_PROG_CPP
   called before AC_PROG_CC</code>. These messages can usually be ignored.</p>
  </div>
 </li>

 <li>
  Run <code>./buildconf</code> to generate the configure script. This may take several moments.
 </li>

 <li>
  From this point onwards, installation is similar to the installation of one of
  the official packages with one main difference &ndash; you may need bison 1.28 or later
  and flex 2.5.4 (PHP 5.2 and earlier) or re2c 0.13.4+ or later (PHP 5.3 and later) to
  compile, because the pre-generated scanner and parser files may not
  be included in SVN.
 </li>
</ol>

<p>
 There are many other things, such as the XML source code
 for the documentation, available via SVN. See
 <a href="http://svn.php.net/">the web-based view of the SVN
 server</a> to see what is available. For example, to checkout the
 latest english version of the PHP manual:<br />
 <code>svn checkout http://svn.php.net/repository/phpdoc/en/trunk ./phpdoc-en</code>
</p>

<a name="buildconf_fail"></a>
<h2>autoconf, automake and libtool information</h2>

<p>
 There seem to be problems with libtool 1.4.2. It is suggested
 that you use libtool 1.4, along with autoconf 2.13 and
 automake 1.4. You should also ensure that autoconf, automake
 and libtool are installed in the same directory. libtool 1.5
 will not work.
</p>

<p>The following combinations are known to work:</p>
<ul>
 <li>autoconf 2.13, automake 1.4 and libtool 1.4.3</li>
 <li>autoconf 2.13, automake 1.5 and libtool 1.4.3</li>
 <li>autoconf 2.63, automake 1.11 and libtool 2.2.6 (with many warnings)</li>
</ul>

<p>
 If you have multiple versions of autoconf installed on your computer, as is
 common for many UNIXes, you can set the PHP_AUTOCONF and PHP_AUTOHEADER
 variables when running buildconf to indicate which versions it should use
 e.g.:<br />
 <code>PHP_AUTOCONF=autoconf213 PHP_AUTOHEADER=autoheader213 ./buildconf</code>
</p>

<a name="flex_fail"></a>
<h2>Zend/zend_language_scanner.c: No such file or directory</h2>

<p>
 PHP only supports flex 2.5.4, <strong>not</strong> later versions as they broke backwards compatibility.
 Please note that PHP 5.3 and later do not require flex at all.
</p>

<?php site_footer(); ?>