Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Trim mirroring docs #1036

Merged
merged 3 commits into from
Jul 21, 2024
Merged

Trim mirroring docs #1036

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
8dc2024
Remove docs.php.net, it's not user-visible any longer (closes #996)
jimwins Jul 20, 2024
54edd6c
Remove old information only relevant to "official" mirrors
jimwins Jul 21, 2024
1f55cd5
Merge branch 'php:master' into trim-mirroring-docs
jimwins Jul 21, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 4 additions & 14 deletions mirroring-troubles.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,13 +12,12 @@
site_header("The PHP mirrors problem and troubleshooting guide", ["current" => "help"]);
?>

<h1>Common troubles that PHP.net mirrors face</h1>
<h1>Common troubles that mirrors of PHP.net face</h1>
<p>
Mirroring a PHP.net server requires a few specific settings and
Mirroring the PHP.net website requires a few specific settings and
considerations, and this document provides a list of problems with possible
solutions. The mirror tools check for these problems and automatically
disable the problematic mirrors. The [<strong>?</strong>] link within each
title may be used to test this mirror.
solutions. The [<strong>?</strong>] link within each title may be used to
test this mirror.
</p>

<a name="multiviews"></a>
Expand Down Expand Up @@ -103,15 +102,6 @@
<code>AddType application/octet-stream .msi</code>
</p>

<a name="slow"></a>
<h3>Slow response time</h3>
<p>
Although this test is currently a little unfair (it's only based from the
USA), the response time of the server exceeds five seconds. Please confirm
the speed of these mirrors and we'll likely adjust the testing procedure.
This test will be performed from multiple locations in the future.
</p>

<a name="outbound"></a>
<h3>Unable to do external searches [<a href="results.php?q=curl&p=manual&l=en">?</a>]</h3>
<p>
Expand Down
89 changes: 3 additions & 86 deletions mirroring.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,16 +8,6 @@
mirrors page</a>.
</p>
';
/*
<h3>SVN repository mirroring</h3>
<p>
If you are interested in using a local copy of our
SVN repository for yourself, we provide
<a href="/svnsync.php">svnsync instructions</a>
separately.
</p>
';
*/

site_header(
'Mirroring The PHP Website',
Expand All @@ -32,7 +22,7 @@

<p>
The PHP project does not have an official mirror program anymore, but you can
set-up a mirror for your own network or company.
set up a mirror for your own network or company.
</p>

<p>
Expand Down Expand Up @@ -80,13 +70,6 @@
<code>"--exclude='distributions/**' --exclude='extra/**'"</code>.
</p>

<p>
PHP mirror sites should provide the exact content coming from our servers,
and must not be altered in any way unless explicitly stated in the mirroring
guidelines. Failing to do will result in immediate termination and permanent
expulsion of your participation in the program.
</p>

<h2>Add SQLite 3 Support</h2>

<p>
Expand Down Expand Up @@ -154,11 +137,6 @@
# Set mirror's preferred language here
SetEnv MIRROR_LANGUAGE "en"

# The next two lines are only necessary if generating
# stats (see below), otherwise you should comment them out
Alias /stats/ /path/to/local/stats/
SetEnv MIRROR_STATS 1

# Apache2 has 'AddHandler type-map var' enabled by default.
# Remove the comment sign on the line below if you have it enabled.
# RemoveHandler var
Expand Down Expand Up @@ -198,14 +176,6 @@
site should start working.
</p>

<h2>Setting Up Local Stats</h2>

<p>
Setting up local stats can be a plus on your mirror. We
provide <a href="/mirroring-stats.php">some setup
instructions for that</a>.
</p>

<h2>Setup Regular Updates</h2>

<p>
Expand All @@ -228,66 +198,13 @@
minutes.
</p>

<h2>Sponsor Logo</h2>

<p>
We would like to thank you for providing a mirror, so
if you would like to display a logo on the mirror site promoting your
company, you are able to do so by following these steps:
</p>

<ul>
<li>Create a 120 x 60 pixel sized logo button.</li>
<li>Copy it to your <code>/www/htdocs/phpweb/backend</code> folder as <code>mirror.gif</code>, <code>mirror.jpg</code> or <code>mirror.png</code>.</li>
<li>Go visit your mirror URL (e.g. http://foo.php.net/mirror.php) and check if it is there.</li>
</ul>

<p>
The <a href="/credits.php">PHP Group</a> and the Network Infrastructure Manager reserve the
right to refuse images based on content, but most things should be fine.
</p>

<p>
We have chosen a banner size which conforms with the
<a href="http://www.iab.net/standards/adunits.asp">Internet
Advertising Bureau standards</a>.
</p>

<p>
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 <a href="/download-logos.php">logos download</a> page, and
link it to your mirror. This shows the community that you are a
proud supporter of PHP and open source technology.
</p>

<h2>Mirror Setup Troubleshooting</h2>

<p>
The <a href="/mirroring-troubles.php">mirror troubleshooting guide</a>
contains information about the common and potential problems discovered
when setting up and maintaining a PHP.net mirror. Included are links that
perform many of the tests executed by the automated mirror management tools.
</p>

<p>
There is a mailing list named <code>"php-mirrors"</code> at
<code>lists.php.net</code>, to which you can subscribe.
This mailing list is very low-traffic and only used for communication
between mirror maintainers and php.net webmasters.
</p>
<p>
To subscribe send an empty message
to: <a href="mailto:[email protected]">[email protected]</a>
</p>

<p>
<em>
Thank you for your interest in providing a mirror! If you ever have any
questions or concerns, drop us a line at
<a href="mailto:[email protected]">[email protected]</a>
--- we are here to help!
</em>
when setting up and maintaining a mirror of PHP.net. Included are links that
can help demonstrate common configuration problems.
</p>

<?php site_footer(); ?>
Loading