mirror of
https://github.com/php/web-php.git
synced 2026-03-23 23:02:13 +01:00
f1f5e30ca3
welcome! A couple of important notes: - I've largely dropped references to Subversion altogether, even knowing that php-doc hasn't migrated yet. We may need to put a few more "Git/SVN account" references in there if php-doc isn't going to be migrated in the near future. - I've removed the quick start hints from git-php.php after an account request has been sent in. The documentation there was pretty skimpy anyway and probably wouldn't have been enough to get a developer going, plus it's harder to distill the Git workflow into three or four snappy commands and I'm not really convinced that a form confirmation page is the right place to have learning materials, since it's a one-time page for most users. Instead I've replaced them with links to the relevant Wiki pages, which seem more likely to be the right place for new developers to learn. News post to come, but I wanted to separate this out for easier review.
189 lines
5.8 KiB
PHP
189 lines
5.8 KiB
PHP
<?php
|
|
// $Id$
|
|
$_SERVER['BASE_PAGE'] = 'git.php';
|
|
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/prepend.inc';
|
|
$SIDEBAR_DATA = '
|
|
<h3>What is Git?</h3>
|
|
<p>
|
|
You can find more information about Git and download clients for most major
|
|
platforms at <a href="http://git-scm.com/">the official Git site</a>.
|
|
</p>
|
|
|
|
<p>
|
|
The <a href="http://progit.org/">Pro Git book</a> may also be useful.
|
|
</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 may want <a href="/git-php.php">your own Git 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("Git Access", array("current" => "community"));
|
|
?>
|
|
|
|
<h1>Git Access</h1>
|
|
|
|
<p>
|
|
If you wish to get the latest PHP source tree, you can obtain it through Git.
|
|
You should be warned that the Git version is a development version, and as
|
|
such, is often unstable, and may not even compile properly. The advantage of
|
|
using Git, 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 (2.59+ for PHP 5.4+)</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 Git</h2>
|
|
|
|
<ol>
|
|
<li>
|
|
You can retrieve the PHP source code from
|
|
<a href="http://git.php.net/">git.php.net</a> with this command:
|
|
<br /><br />
|
|
<code>git clone http://git.php.net/repository/php-src.git</code>
|
|
<br /><br />
|
|
|
|
Or from the <a href="https://github.com/php/php-src">GitHub mirror</a>, which
|
|
you may want to use if you plan to create pull requests:
|
|
<br /><br />
|
|
<code>git clone https://github.com/php/php-src.git</code>
|
|
<br /><br />
|
|
</li>
|
|
|
|
<li>
|
|
Make sure you're in the right directory to work on PHP:
|
|
<br /><br />
|
|
<code>cd php-src</code>
|
|
<br /><br />
|
|
</li>
|
|
|
|
<li>
|
|
You can then check out the branch you want to build:
|
|
<br /><br />
|
|
<strong>PHP 5.3</strong>:
|
|
<code>git checkout PHP-5.3</code>
|
|
<br />
|
|
<strong>PHP 5.4</strong>:
|
|
<code>git checkout PHP-5.4</code>
|
|
<br />
|
|
<strong>PHP HEAD</strong>:
|
|
<code>git checkout master</code>
|
|
<br /><br />
|
|
</li>
|
|
|
|
<li>
|
|
<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 – 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 Git.
|
|
</li>
|
|
</ol>
|
|
|
|
<p>
|
|
There are many other things, such as the XML source code
|
|
for the documentation, available via Git. See
|
|
<a href="http://git.php.net/">the web-based view of the Git
|
|
server</a> to see what is available.
|
|
</p>
|
|
|
|
<p>
|
|
The PHP Wiki has a useful
|
|
<a href="https://wiki.php.net/vcs/gitfaq">Git FAQ</a>, which provides useful
|
|
tips and cheatsheets for using the PHP Git repository, and if you want to
|
|
become involved in developing PHP, the
|
|
<a href="https://wiki.php.net/vcs/gitworkflow">Git Workflow</a> page is also
|
|
likely to be of interest.
|
|
</p>
|
|
|
|
<h2>PHP manual</h2>
|
|
|
|
<p>
|
|
The PHP manual is still currently hosted on SVN, although it will be migrated
|
|
to Git in the near future. To checkout the latest English version of the PHP
|
|
manual:<br />
|
|
<code>svn checkout https://svn.php.net/repository/phpdoc/modules/doc-en ./phpdoc-en</code>
|
|
<br /><br />
|
|
You can also check the <a href="https://wiki.php.net/vcs/svnfaq">SVN FAQ on the wiki</a>.
|
|
</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 with PHP 5.3 and below:</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>
|
|
</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(); ?>
|