mirror of
https://github.com/php/web-php.git
synced 2026-03-23 23:02:13 +01:00
98 lines
4.3 KiB
Plaintext
98 lines
4.3 KiB
Plaintext
NOTE: If you want to become an official PHP mirror, please sure to
|
|
read and follow these instructions carefully. You should have the
|
|
consent of your hosting company (if you aren't a hosting company
|
|
yourself), and be prepared for some reasonably significant bandwidth
|
|
usage (a reasonable estimate as of 2/2001 is 100MB/day). Also,
|
|
we are currently only accepting new official mirrors in countries
|
|
where we don't already have two active official mirrors.
|
|
|
|
Here is how to mirror the PHP site:
|
|
|
|
First, you need to have a rsync (http://rsync.samba.org/) installed.
|
|
|
|
Fetch the web files with the following:
|
|
|
|
rsync -avzC --delete --delete-after rsync.php.net::phpweb /your/local/path
|
|
|
|
If /your/local/path isn't in your web document tree (why isn't it?),
|
|
then symlink the phpweb/ directory to the correct place on your server.
|
|
|
|
Now, make sure your web server is set up to serve up .php3 and .php
|
|
files as PHP parsed files. If it isn't, add the mime-type to your config.
|
|
|
|
Rename the configuration.inc-dist file to configuration.inc and edit it
|
|
appropriately. Set $failover_user_notes=true to enable a live query
|
|
to www.php.net to fetch user contributed manual notes.
|
|
|
|
Once you create a virtualhost which looks something like:
|
|
|
|
<VirtualHost xx.php.net>
|
|
ServerName xx.php.net
|
|
ServerAlias www.xx.php.net
|
|
ServerAdmin yourname@yourdomain.com
|
|
DocumentRoot /www/htdocs/phpweb
|
|
<IfModule mod_php3.c>
|
|
php3_include_path .:/www/htdocs/phpweb/include
|
|
</IfModule>
|
|
<IfModule mod_php4.c>
|
|
php_value include_path .:/www/htdocs/phpweb/include
|
|
</IfModule>
|
|
ErrorLog logs/error_log
|
|
TransferLog logs/access_log
|
|
DirectoryIndex index.php index.html
|
|
ErrorDocument 404 /error/
|
|
ErrorDocument 401 /error/
|
|
ErrorDocument 403 /error/
|
|
</VirtualHost>
|
|
|
|
modified to reflect your local paths and country, of course, then your site
|
|
should start working.
|
|
|
|
Note: The official names for PHP mirrors are in the convention: "xx.php.net",
|
|
where "xx" is replaced by the 2-letter country code of your mirror's location.
|
|
If there already is a "xx.php.net", then you should set up your ServerName to
|
|
be "xx2.php.net" (or "xx3.php.net", etc.). For a list of what's available and
|
|
what is taken, have a look at http://www.php.net/mirror_list.txt.
|
|
|
|
You must also set up a cron job that periodically does an rsync to refresh
|
|
your web directory. This will ensure that your web site is up to date.
|
|
Something like:
|
|
|
|
0,30 * * * * /usr/local/bin/rsync -avzC --delete rsync.php.net::phpweb /your/path
|
|
|
|
(You don't need to update every half-hour, although it shouldn't
|
|
hurt. You should try to stagger your times a bit from the example
|
|
to help spread the load on the rsync.php.net server.)
|
|
|
|
Once you have done the above and your site appears to work, send
|
|
a message to mirrors@php.net with the following information, and
|
|
appropriate steps will be taken to integrate your mirror site:
|
|
|
|
- Your name and email address as the admin for the mirror.
|
|
- Your country (we will update the DNS for php.net).
|
|
- A hostname that we can use as a CNAME for the country-code-based
|
|
name of the mirror. (This is preferable to an IP address, because
|
|
it means you can move the mirror to another IP address without
|
|
coordinating with us at all.)
|
|
- Whether or not you've installed local searching support on your mirror.
|
|
This uses ht://Dig (http://www.htdig.org), for which instructions for
|
|
setting it up can be found in Mirrors-htdig.tgz
|
|
- The name of your hosting company.
|
|
- The URL of the site that hosts the mirror. This is where you want
|
|
people will go when they click on the link for your mirror at the
|
|
bottom of each page.
|
|
- The preferred default language for your country (currently only
|
|
the manuals are translated). Don't worry if there's no content
|
|
available in the preferred language yet, so long as English is
|
|
an acceptable secondary default.
|
|
|
|
It is *not* required to sign up to the mirrors mailing list, by
|
|
sending an empty message to: php-mirrors-subscribe@lists.php.net
|
|
as we are able to keep in touch with you using your given email
|
|
address. The traffic on the mentioned mailing list is mainly
|
|
interesting for the webmasters of php.net.
|
|
|
|
And finally, don't forget to put a nice little PHP logo somewhere on your
|
|
hosting company's site if possible. Grab one of the logos from the
|
|
"Downloads" page on the PHP site, and link it to your mirror.
|