PHP Standard Recommendations (PSRs) are a collection of guidelines developed by the PHP Framework Interoperability Group (PHP-FIG). These standards ensure consistency, readability, and maintainability in PHP code across different projects and frameworks. In this article, we will explore the most important PSR standards and their practical implications.<\/p>\n\n\n\n
PSR-1 lays down the foundational rules for PHP coding practices. It covers PHP tags, encoding, naming conventions, and class structure. The primary goal of PSR-1 is to ensure that code is interoperable between different frameworks and libraries.<\/p>\n\n\n\n
<?php<\/code> and <?=<\/code> tags.<\/li>\n\n\n\n- Files must use UTF-8 encoding without a BOM (Byte Order Mark).<\/li>\n\n\n\n
- Class names must follow the PascalCase convention.<\/li>\n\n\n\n
- Constants must be declared in all uppercase with underscores separating words.<\/li>\n\n\n\n
- Method names must be declared in camelCase.<\/li>\n<\/ul>\n\n\n\n
Example:<\/strong><\/p>\n\n\n\n<?php\n\nnamespace App\\Controllers;\n\nclass UserController\n{\n public function getUser($id)\n {\n return \"User ID: \" . $id;\n }\n}\n<\/code><\/pre>\n\n\n\nHere, we use PascalCase<\/code> for the class name (UserController<\/code>) and camelCase<\/code> for method names (getUser<\/code>), which follow PSR-1 guidelines.<\/p>\n\n\n\n2. PSR-2: Coding Style Guide<\/strong><\/h3>\n\n\n\nPSR-2 builds on PSR-1 and provides a detailed coding style guide. It ensures that all PHP code is written in a consistent format, making it easier for developers to read and maintain the code.<\/p>\n\n\n\n
Key Guidelines of PSR-2:<\/strong><\/h4>\n\n\n\n\n- Use 4 spaces for indentation, no tabs.<\/li>\n\n\n\n
- The opening brace for classes and methods must be on the next line.<\/li>\n\n\n\n
- Control structures like
if<\/code>, else<\/code>, and while<\/code> should have braces on the same line.<\/li>\n<\/ul>\n\n\n\nExample:<\/strong><\/p>\n\n\n\n<?php\n\nclass Calculator\n{\n public function add($a, $b)\n {\n if ($a === 0) {\n return $b;\n } else {\n return $a + $b;\n }\n }\n}\n<\/code><\/pre>\n\n\n\nNotice the 4-space indentation, and how the opening brace for the method appears on the next line, adhering to PSR-2 standards.<\/p>\n\n\n\n
3. PSR-3: Logger Interface<\/strong><\/h3>\n\n\n\nPSR-3 standardizes a logging interface that allows developers to log messages in a consistent way. The advantage of PSR-3 is that it abstracts the logging logic, allowing developers to switch between different logging libraries without rewriting code.<\/p>\n\n\n\n
Key Methods of PSR-3:<\/strong><\/h4>\n\n\n\n\ndebug()<\/code>: Logs detailed debug information.<\/li>\n\n\n\ninfo()<\/code>: Logs informational messages.<\/li>\n\n\n\nnotice()<\/code>: Logs normal but significant events.<\/li>\n\n\n\nerror()<\/code>: Logs runtime errors that do not require immediate action.<\/li>\n<\/ul>\n\n\n\nExample:<\/strong><\/p>\n\n\n\n<?php\n\nuse Psr\\Log\\LoggerInterface;\n\nclass OrderController\n{\n private $logger;\n\n public function __construct(LoggerInterface $logger)\n {\n $this->logger = $logger;\n }\n\n public function placeOrder($orderId)\n {\n $this->logger->info('Placing order with ID: ' . $orderId);\n \/\/ Code to place the order\n }\n}\n<\/code><\/pre>\n\n\n\nIn this example, the logger is passed to the controller, allowing the info()<\/code> method to log the order placement.<\/p>\n\n\n\n4. PSR-4: Autoloading Standard<\/strong><\/h3>\n\n\n\nPSR-4 defines a way to automatically load classes from the file system, avoiding the need to manually include files. The file paths must map to namespaces, allowing easy loading of classes based on their names.<\/p>\n\n\n\n
Key Rules of PSR-4:<\/strong><\/h4>\n\n\n\n\n- Namespace prefixes must match the file directory structure.<\/li>\n\n\n\n
- The class name must map to a file path relative to the namespace.<\/li>\n<\/ul>\n\n\n\n
Example:<\/strong><\/p>\n\n\n\n\/\/ Directory: src\/Controllers\/ProductController.php\n\nnamespace App\\Controllers;\n\nclass ProductController\n{\n public function showProducts()\n {\n echo \"Showing products\";\n }\n}\n\n\/\/ In composer.json:\n\"autoload\": {\n \"psr-4\": {\n \"App\\\\\": \"src\/\"\n }\n}\n<\/code><\/pre>\n\n\n\nThis PSR-4 autoloads the ProductController<\/code> class when it is called, mapping the App\\Controllers<\/code> namespace to the src\/Controllers\/<\/code> directory.<\/p>\n\n\n\n5. PSR-7: HTTP Message Interface<\/strong><\/h3>\n\n\n\nPSR-7 defines common interfaces for working with HTTP requests and responses. It provides a consistent way to handle HTTP interactions between the client and the server, making it easier to integrate different libraries or frameworks.<\/p>\n\n\n\n
Key PSR-7 Interfaces:<\/strong><\/h4>\n\n\n\n\nRequestInterface<\/code>: Handles the HTTP request.<\/li>\n\n\n\nResponseInterface<\/code>: Handles the HTTP response.<\/li>\n<\/ul>\n\n\n\nExample:<\/strong><\/p>\n\n\n\n<?php\n\nuse Psr\\Http\\Message\\ResponseInterface;\nuse Psr\\Http\\Message\\ServerRequestInterface;\n\nclass ApiController\n{\n public function getResponse(ServerRequestInterface $request, ResponseInterface $response)\n {\n $response->getBody()->write('Hello, World!');\n return $response;\n }\n}\n<\/code><\/pre>\n\n\n\nIn this example, PSR-7 handles the HTTP request and modifies the response body with a message.<\/p>\n\n\n\n
6. PSR-12: Extended Coding Style Guide<\/strong><\/h3>\n\n\n\nPSR-12 expands on PSR-2, focusing on more modern PHP features and stricter coding practices, including typing, visibility declarations, and more.<\/p>\n\n\n\n
Key Guidelines of PSR-12:<\/strong><\/h4>\n\n\n\n