pear:rfc:pear2_class_naming
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
pear:rfc:pear2_class_naming [2009/05/28 16:32] – update abstract/interface examples based on PHP Standards decisions ashnazg | pear:rfc:pear2_class_naming [2017/09/22 13:28] (current) – external edit 127.0.0.1 | ||
---|---|---|---|
Line 3: | Line 3: | ||
==== Document Information ==== | ==== Document Information ==== | ||
* Title: PEAR2 Class Naming Conventions | * Title: PEAR2 Class Naming Conventions | ||
- | * Version: | + | * Version: 1.0.0 |
- | * Status: | + | * Status: |
* Type: Informative Document | * Type: Informative Document | ||
* Wiki link: http:// | * Wiki link: http:// | ||
+ | * Last Updated: | ||
+ | * Passed: | ||
+ | |||
+ | This RFC has been incorporated into the PEAR2 Standards ([[pear/ | ||
==== Author(s) Information ==== | ==== Author(s) Information ==== | ||
* Name: Chuck Burgess | * Name: Chuck Burgess | ||
- | * Name: | + | * Name: |
* Email: [[pear-group@php.net]] | * Email: [[pear-group@php.net]] | ||
Line 33: | Line 37: | ||
New guidelines for PEAR2: | New guidelines for PEAR2: | ||
* syntax/ | * syntax/ | ||
- | * such suffixing is required for abstract classes and interfaces, for additional clarity to non-native English readers | + | * such suffixing is required for abstract classes and interfaces, for additional clarity to non-native English readers |
===== Issues ===== | ===== Issues ===== | ||
Line 39: | Line 43: | ||
===== Proposed Solution ===== | ===== Proposed Solution ===== | ||
+ | |||
Initial rules and guidelines: | Initial rules and guidelines: | ||
* a suffix for an Abstract or Interface class name is required | * a suffix for an Abstract or Interface class name is required | ||
Line 44: | Line 49: | ||
* the suffix should be a full legible word, not a cryptic letter/ | * the suffix should be a full legible word, not a cryptic letter/ | ||
* this follows other well-known conventions (e.g. Java) | * this follows other well-known conventions (e.g. Java) | ||
+ | |||
+ | The only exception to the Interface suffix requirement is the base package exception, which must be named simply " | ||
+ | |||
+ | One benefit of the suffix rather than a prefix is in alphabetical-based visual listing of classes. | ||
===== Examples ===== | ===== Examples ===== |
pear/rfc/pear2_class_naming.1243528362.txt.gz · Last modified: 2017/09/22 13:28 (external edit)