search
HomeBackend DevelopmentPHP Tutorial[PHP] PSR brief specification

PSR is a series of specifications about PHP development. There are several versions. I learned it superficially, but I still hope to check the specifications from time to time. In order to facilitate memory and follow, I picked out the necessary keywords and made a Simply necessary normative records. (Just a brick mover...)
https://github.com/PizzaLiu/PHP-FIG
http://segmentfault.com/a/1190000002521577

Official release file version

PSR-0(deprecated)

PSR-1 Basic Code Specification

PSR-2 Code Style Specification

PSR-2 Supplementary Documentation

PSR-3 log interface specification

PSR-4 automatically loaded

PSR-5 and PSR-6 voting has not passed yet

must PSR-1 Basic Code Specification

php code file must start with

PHP code files must be encoded in UTF-8 without BOM;

Namespaces and classes must comply with PSR’s autoloading specification: one of PSR-0 or PSR-4;

The naming of classes must follow the StudlyCaps camel case naming convention starting with an uppercase letter;

All letters of constants in the class must be capitalized, and words are separated by underscores;

Method names must comply with camelCase-style camelCase naming convention starting with lowercase.

PHP code must use long tag or = ?> short output tag; other custom tags must not be used.

Namespace and class naming must comply with PSR-0.

Code for PHP 5.3 and later versions must use formal namespaces.

Each class is an independent file, and the namespace has at least one level: the top-level organization name (vendor name)

PSR-2 coding style guide

Code must follow the coding specifications in PSR-1.

Code must be indented using 4 spaces instead of the tab key.

Note: The advantage of using spaces instead of tab keys for indentation is to avoid confusion when comparing code differences, patching, reviewing code, and comments. Also, use spaces for indentation to make alignment easier.

A blank line must be inserted after each namespace declaration statement and use declaration block.

The opening curly brace ({) of the class must be written on its own line after the function declaration, and the closing curly brace (}) must also be written on its own line after the function body.

The opening curly brace ({) of the method must be written on its own line after the function declaration, and the closing curly brace (}) must also be written on its own line after the function body.

The properties and methods of the class must add access modifiers (private, protected and public), abstract and final must be declared before the access modifier, and static must be declared after the access modifier.

There must be a space after the keyword of the control structure, but it must not be when calling a method or function.

The opening brace ({) of the control structure must be written on the same line as the declaration, and the closing brace (}) must be written on its own line after the body.

There must be no spaces after the opening left bracket and before the closing right bracket of the control structure.

All PHP files must use Unix LF (linefeed) as the line terminator.

All PHP files must end with a blank line.

Pure PHP code files must omit the final ?> closing tag.

There must not be more than one statement per line.

There must be no extra spaces after non-blank lines.

All PHP keywords must be in lowercase.

The constants true, false and null must also be all lowercase.

PSR-3 log interface specification PSR-4 automatic loading specification

A complete class name must have the following structure:

  1. ()*
  2. The complete class name must have a top-level namespace , is called a "vendor namespace";
  3. A complete class name can have one or more sub-namespaces;
  4. A complete class name must have a final class name;
  5. A drop in any part of a complete class name Lines have no special meaning;
  6. The complete class name can be composed of any uppercase and lowercase letters;
  7. All class names must be case-sensitive.
Copy the code

When loading the corresponding file based on the complete class name

  1. In the complete class name, remove the first namespace separator, one or more consecutive namespaces and subnames in front Space, as a "namespace prefix", must correspond to at least one "file base directory";
  2. The sub-namespace immediately following the namespace prefix must match the corresponding "file base directory", in which the namespace separator will serve as the directory separator. The class name at the end of
  3. must have the same name as the corresponding file with the .php suffix.
  4. The implementation of the autoloader must not throw exceptions, must not trigger error messages at any level, and should not have a return value.
Copy code
Suggestions (please view detailed documentation for more information) PSR-1

PHP code should only define declarations such as classes, functions, constants, etc., or other operations that will produce subordinate effects (such as generating file output and modifying .ini configuration files, etc.). You can only choose one of the two;

The attribute naming of the class can follow the camel case starting with upper case ($StudlyCaps), the camel case starting with lower case ($camelCase), or the underline delimited format ($under_score). This specification does not make it mandatory, but no matter which naming is followed methods should be consistent within a certain range.

PSR-2

The number of characters per line should be softly kept within 80. In theory, it must not exceed 120, but there must be no hard limit.

Blank lines make it easier to read code and help break up code into chunks.

code example PSR-2
  1. namespace VendorPackage;
  2. use FooInterface;
  3. use BarClass as Bar;
  4. use OtherVendorOtherPackageBazClass;
  5. class Foo extends Bar implements FooInterface
  6. {
  7. public function sampleFunction($a, $b = null)
  8. {
  9. if ($a === $b) {
  10. bar();
  11. } elseif ($a > $b) {
  12. $foo->bar($arg1);
  13. } else {
  14. BazClass::bar($arg2, $arg3);
  15. }
  16. }
  17. final public static function bar()
  18. {
  19. // method body
  20. }
  21. }
Copy code
PHP, PSR


Statement
The content of this article is voluntarily contributed by netizens, and the copyright belongs to the original author. This site does not assume corresponding legal responsibility. If you find any content suspected of plagiarism or infringement, please contact admin@php.cn
How to calculate the total number of elements in a PHP multidimensional array?How to calculate the total number of elements in a PHP multidimensional array?May 15, 2025 pm 09:00 PM

Calculating the total number of elements in a PHP multidimensional array can be done using recursive or iterative methods. 1. The recursive method counts by traversing the array and recursively processing nested arrays. 2. The iterative method uses the stack to simulate recursion to avoid depth problems. 3. The array_walk_recursive function can also be implemented, but it requires manual counting.

What are the characteristics of do-while loops in PHP?What are the characteristics of do-while loops in PHP?May 15, 2025 pm 08:57 PM

In PHP, the characteristic of a do-while loop is to ensure that the loop body is executed at least once, and then decide whether to continue the loop based on the conditions. 1) It executes the loop body before conditional checking, suitable for scenarios where operations need to be performed at least once, such as user input verification and menu systems. 2) However, the syntax of the do-while loop can cause confusion among newbies and may add unnecessary performance overhead.

How to hash strings in PHP?How to hash strings in PHP?May 15, 2025 pm 08:54 PM

Efficient hashing strings in PHP can use the following methods: 1. Use the md5 function for fast hashing, but is not suitable for password storage. 2. Use the sha256 function to improve security. 3. Use the password_hash function to process passwords to provide the highest security and convenience.

How to implement array sliding window in PHP?How to implement array sliding window in PHP?May 15, 2025 pm 08:51 PM

Implementing an array sliding window in PHP can be done by functions slideWindow and slideWindowAverage. 1. Use the slideWindow function to split an array into a fixed-size subarray. 2. Use the slideWindowAverage function to calculate the average value in each window. 3. For real-time data streams, asynchronous processing and outlier detection can be used using ReactPHP.

How to use the __clone method in PHP?How to use the __clone method in PHP?May 15, 2025 pm 08:48 PM

The __clone method in PHP is used to perform custom operations when object cloning. When cloning an object using the clone keyword, if the object has a __clone method, the method will be automatically called, allowing customized processing during the cloning process, such as resetting the reference type attribute to ensure the independence of the cloned object.

How to use goto statements in PHP?How to use goto statements in PHP?May 15, 2025 pm 08:45 PM

In PHP, goto statements are used to unconditionally jump to specific tags in the program. 1) It can simplify the processing of complex nested loops or conditional statements, but 2) Using goto may make the code difficult to understand and maintain, and 3) It is recommended to give priority to the use of structured control statements. Overall, goto should be used with caution and best practices are followed to ensure the readability and maintainability of the code.

How to implement data statistics in PHP?How to implement data statistics in PHP?May 15, 2025 pm 08:42 PM

In PHP, data statistics can be achieved by using built-in functions, custom functions, and third-party libraries. 1) Use built-in functions such as array_sum() and count() to perform basic statistics. 2) Write custom functions to calculate complex statistics such as medians. 3) Use the PHP-ML library to perform advanced statistical analysis. Through these methods, data statistics can be performed efficiently.

How to use anonymous functions in PHP?How to use anonymous functions in PHP?May 15, 2025 pm 08:39 PM

Yes, anonymous functions in PHP refer to functions without names. They can be passed as parameters to other functions and as return values ​​of functions, making the code more flexible and efficient. When using anonymous functions, you need to pay attention to scope and performance issues.

See all articles

Hot AI Tools

Undresser.AI Undress

Undresser.AI Undress

AI-powered app for creating realistic nude photos

AI Clothes Remover

AI Clothes Remover

Online AI tool for removing clothes from photos.

Undress AI Tool

Undress AI Tool

Undress images for free

Clothoff.io

Clothoff.io

AI clothes remover

Video Face Swap

Video Face Swap

Swap faces in any video effortlessly with our completely free AI face swap tool!

Hot Article

Hot Tools

VSCode Windows 64-bit Download

VSCode Windows 64-bit Download

A free and powerful IDE editor launched by Microsoft

Notepad++7.3.1

Notepad++7.3.1

Easy-to-use and free code editor

SAP NetWeaver Server Adapter for Eclipse

SAP NetWeaver Server Adapter for Eclipse

Integrate Eclipse with SAP NetWeaver application server.

SublimeText3 Mac version

SublimeText3 Mac version

God-level code editing software (SublimeText3)

ZendStudio 13.5.1 Mac

ZendStudio 13.5.1 Mac

Powerful PHP integrated development environment