controversial_changes

Anonymous (anonymous@undisclosed.example.com) — 2025-04-03T13:08:43+00:00

2026/04/05 14:34	current
Line 1:	Line 1:
	+	====== Controversial Changes to PEAR2 Standards ======
	+	See [[pear:rfc:pear2_standards]]
	+
	+	====== Summary ======
	+
	+	===== Information =====
	+
	+	==== Document Information ====
	+	* Title: PEAR2 Coding Standards Controversial Changes
	+	* Version: 0.4.0
	+	* Status: Draft
	+	* Type: Standards
	+	* Last updated: September 3rd, 2007
	+
	+	==== Author(s) Information ====
	+	* Name: Gregory Beaver
	+	* Email: cellog@php.net
	+
	+	==== Legal Information ====
	+
	+	* This proposal is under CC-By-Sharealike ([http://creativecommons.org/licenses/by-sa/3.0/]) licensing.
	+
	+	==== Discussion List ====
	+	* Mailing List: http://news.php.net/php.pear.dev
	+
	+	===== Introduction =====
	+
	+	This document itemizes changes to the coding standards that refer to loading of external files containing classes.
	+
	+	These have been extracted from the general [[PEAR2 Standards]].
	+
	+	Documenting the location of external classes (classes not contained within a file)
	+	is an important problem to solve within PEAR2. There are two kinds of external classes:
	+
	+	- those contained within the current package
	+	- external package dependencies
	+
	+	This recommendation defines how to handle both
	+
	+	===== Summary =====
	+
	+	This document describes the coding standards and coding conventions for the new PEAR2 repository.
	+
	+	===== Approach & Requirements =====
	+
	+	Packages that wish to be accepted into the PEAR2 repository must conform to these standards
	+
	+	===== Definition =====
	+
	+
	+	==== Handling dependencies ====
	+
	+	File dependencies (required and optional) should be registered at the top of the file using /** */ documentation comments as well as with full import statements:
	+
	+	<?php
	+	/**
	+	* My Package
	+	* @uses PEAR2::SomeotherPackage in PEAR2/SomeotherPackage.php (package PEAR2::Someotherpackage must be installed)
	+	* @uses PEAR2::PackageName::Exception in PEAR2/PackageName/Exception.php
	+	* @package PEAR2_PackageName
	+	*/
	+	namespace PEAR2;
	+	use ::PEAR2::PackageName::Exception as Exception;
	+	use ::PEAR2::SomeotherPackage as PEAR2::SomeotherPackage;
	+	?>
	+
	+	=== Requirement ===
	+	No Exceptions to this rule

PHP Wiki - pear:rfc:pear2_standards

controversial_changes