Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
branch: master
Fetching contributors…

Cannot retrieve contributors at this time

117 lines (82 sloc) 4.714 kb
DEVELOPER'S GUIDE FOR ``pearweb´´ CODE
========================================================================
Read this before starting to hack on the PEAR website.
1) Coding Standards
------------------------------------------------------------------------
Code for the PEAR website strictly follows the PEAR Coding Standards
[1].
If changes that do not follow these standards are committed to the
repository, they will be reverted.
Usage of '@' to silence warnings and notices is discouraged. Use it
only if no clean solution exists.
2) Only commit working code
------------------------------------------------------------------------
People constantly committing code that makes (parts of) the website
inaccessible will lose their SVN karma.
Test your changes before committing them. If you are unable to set
up a test environment, you must not commit anything!
3) Usage of header comment blocks
------------------------------------------------------------------------
Every newly added text file has to carry a header comment block
similar to the following:
/*
+----------------------------------------------------------------------+
| PEAR Web site version 1.0 |
+----------------------------------------------------------------------+
| Copyright (c) 2005 The PEAR Group |
+----------------------------------------------------------------------+
| This source file is subject to version 2.02 of the PHP license, |
| that is bundled with this package in the file LICENSE, and is |
| available at through the world-wide-web at |
| http://www.php.net/license/2_02.txt. |
| If you did not receive a copy of the PHP license and are unable to |
| obtain it through the world-wide-web, please send a note to |
| license@php.net so we can mail you a copy immediately. |
+----------------------------------------------------------------------+
| Author: Martin Jansen <mj@php.net> |
+----------------------------------------------------------------------+
*/
4) Performance
------------------------------------------------------------------------
The PEAR website can be considered a high traffic website, which is
why a content cache is employed. If new sections/pages are added,
one has to make sure that they get cached if it makes sense. (Most
of the time it makes sense.)
Also one has to ensure that newly added code does not lead to
performance issues or bottlenecks.
5) Dependencies
------------------------------------------------------------------------
If new dependencies are introduced, they must be written down in
pearweb/package.xml.
If possible, non-PEAR dependencies and dependencies on packages with
only beta- or alpha-releases must be avoided.
6) Talk first, code later
------------------------------------------------------------------------
If you want to implement new features, ask the PEAR webmaster team
[2] first. Otherwise you may run into serious trouble.
7) Packaging & deployment
------------------------------------------------------------------------
See the instructions in https://wiki.php.net/systems/euk1 for production deployment
Ensure that you have deployed and tested the changes on test.pear.php.net
$ pear upgrade -f package.xml
or a specific area:
$ pear upgrade -f package-pepr.xml
Once you have tested your changes, you can proceed.
Third, make the appropriate pearweb release and push it to pear.php.net. Be sure to update the relevant package_*.php file and generate the new package.xml
$ vim package_pepr.php
$ php package_pepr.php make
$ git commit -m "Release preparation" package-pepr.xml package_pepr.php
$ pear package package-pepr.xml
$ git tag -a pearweb_pepr-1.2.3 -m 'PEARWeb_PEPR-1.2.3'
Join the #pear IRC channel on efnet, and discuss the changes you are about to make.
Next:
$ ssh pear.php.net
$ sudo pear upgrade pearweb
or
$ sudo pear upgrade pearweb_pepr
Apply any mysql, crontab changes manually.
Verify that http://pear.php.net/ is still functioning and update this changelog.
References
------------------------------------------------------------------------
[1] http://pear.php.net/manual/en/standards.php
[2] mailto:pear-webmaster@lists.php.net
Jump to Line
Something went wrong with that request. Please try again.