Introduction to PHP coding development specifications (with examples)-PHP Tutorial-php.cn

Home

Backend Development

PHP Tutorial

Introduction to PHP coding development specifications (with examples)

不言

Apr 01, 2019 am 10:29 AM

php

This article brings you an introduction to PHP coding development specifications (with examples). It has certain reference value. Friends in need can refer to it. I hope it will be helpful to you.

In the past few days, I have been reading a set of Java development specifications "Alibaba Java Development Manual" released by Alibaba Technology. It contains Alibaba's internal Java development specifications and standards, and it is very well written. This set of Java unified specifications will help improve the standardization level of industry coding, help industry personnel improve development quality and efficiency, and greatly reduce code maintenance costs.

After reading this, I searched for some PHP development specifications and standards, and learned that the PSR specification is a set of development standards commonly used in the PHP industry. I lament that I have learned so little and discovered the standard norms so late.

In fact, for novices or developers with several years of experience, we must master these specifications. In many cases, if we do these specifications well, in collaborative development, we can improve the quality and efficiency of our development.

What is PSR?

PSR is the abbreviation of PHP Standard Recommendations. The PHP specification developed by the PHP FIG organization is the practice standard for PHP development.

PHP FIG has currently voted to adopt 6 sets of standards and has been supported and recognized by most PHP frameworks.

Among them, the ones that have passed are:

PSR-1 basic coding specification

PSR-2 coding style specification

PSR-3 log interface specification

PSR-4 automatic loading specification

PSR-6 cache interface specification

PSR-7 HTTP message interface specification

*Note: PSR-0 has been deprecated and PSR-5 is still being drafted and will be added later

Here we first introduce the PSR-1 basic coding specifications

1. Overview

PHP code files must end with

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

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

namespaces and classes must comply with PSR's automatic loading specification: One of [PSR-4](); the naming of the

class must follow the camel case naming convention of StudlyCaps starting with an uppercase letter; all letters of the constants in the

class must be Capitalize, and use underscores to separate words;

method names must conform to camelCase-style camelCase naming convention starting with lowercase.

2. File

##2.1. PHP tag

PHP code must use long tag Or = ?> short output tag;

must not use other custom tags.

2.2. Character encoding

PHP code must and can only use UTF-8 encoding without BOM. (This is very important)

2.3. Side Effects

A PHP file should only define new declarations, such as classes, functions or constants, etc. Operations that produce side effects, or just write logical operations that produce side effects, but not both at the same time.

The term "side effects" means logical operations performed only by including files without directly declaring classes, functions, constants, etc.

"Side effects" include but are not limited to:

The following is a counter-example, a file containing "function declaration" and "side effects" Code:

<?php
// 「副作用」：修改 ini 配置
ini_set(&#39;error_reporting&#39;, E_ALL);
// 「副作用」：引入文件
include "file.php";
// 「副作用」：生成输出
echo "<html>\n";
// 声明函数
function foo()
{
   // 函数主体部分
}

The following is an example, a code that only contains declarations and does not produce "side effects":

<?php
// 声明函数
function foo()
{
   // 函数主体部分
}
// 条件声明 **不** 属于「副作用」
if (! function_exists(&#39;bar&#39;)) {
   function bar()
   {
       // 函数主体部分
   }
}

3. Namespaces and classes

The naming of namespaces and classes must follow [PSR-4]().

According to the specification, each class is an independent file, and the namespace has at least one level: the top-level organization name (vendor name).

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

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

For example:

<?php
// PHP 5.3及以后版本的写法
namespace Vendor\Model;
class Foo
{
}

5.2.x 及之前的版本应该使用伪命名空间的写法，约定俗成使用顶级的组织名称（vendor name）如 Vendor_ 为类前缀。

<?php
// 5.2.x及之前版本的写法
class Vendor_Model_Foo
{
}

4. 类的常量、属性和方法

此处的「类」指代所有的类、接口以及可复用代码块（traits）。

4.1. 常量

类的常量中所有字母都必须大写，词间以下划线分隔。

参照以下代码：

<?php
namespace Vendor\Model;
class Foo
{
   const VERSION = &#39;1.0&#39;;
   const DATE_APPROVED = &#39;2012-06-01&#39;;
}

4.2. 属性

类的属性命名可以遵循：

大写开头的驼峰式 ($StudlyCaps)

小写开头的驼峰式 ($camelCase)

下划线分隔式 ($under_score)

本规范不做强制要求，但无论遵循哪种命名方式，都应该在一定的范围内保持一致。这个范围可以是整个团队、整个包、整个类或整个方法。

4.3. 方法

方法名称必须符合 camelCase() 式的小写开头驼峰命名规范。

【相关推荐：PHP视频教程】

The above is the detailed content of Introduction to PHP coding development specifications (with examples). For more information, please follow other related articles on the PHP Chinese website!

Statement

This article is reproduced at:博客园. If there is any infringement, please contact admin@php.cn delete

The Continued Use of PHP: Reasons for Its EnduranceApr 19, 2025 am 12:23 AM

What’s still popular is the ease of use, flexibility and a strong ecosystem. 1) Ease of use and simple syntax make it the first choice for beginners. 2) Closely integrated with web development, excellent interaction with HTTP requests and database. 3) The huge ecosystem provides a wealth of tools and libraries. 4) Active community and open source nature adapts them to new needs and technology trends.

PHP and Python: Exploring Their Similarities and DifferencesApr 19, 2025 am 12:21 AM

PHP and Python are both high-level programming languages that are widely used in web development, data processing and automation tasks. 1.PHP is often used to build dynamic websites and content management systems, while Python is often used to build web frameworks and data science. 2.PHP uses echo to output content, Python uses print. 3. Both support object-oriented programming, but the syntax and keywords are different. 4. PHP supports weak type conversion, while Python is more stringent. 5. PHP performance optimization includes using OPcache and asynchronous programming, while Python uses cProfile and asynchronous programming.

PHP and Python: Different Paradigms ExplainedApr 18, 2025 am 12:26 AM

PHP is mainly procedural programming, but also supports object-oriented programming (OOP); Python supports a variety of paradigms, including OOP, functional and procedural programming. PHP is suitable for web development, and Python is suitable for a variety of applications such as data analysis and machine learning.

PHP and Python: A Deep Dive into Their HistoryApr 18, 2025 am 12:25 AM

PHP originated in 1994 and was developed by RasmusLerdorf. It was originally used to track website visitors and gradually evolved into a server-side scripting language and was widely used in web development. Python was developed by Guidovan Rossum in the late 1980s and was first released in 1991. It emphasizes code readability and simplicity, and is suitable for scientific computing, data analysis and other fields.

Choosing Between PHP and Python: A GuideApr 18, 2025 am 12:24 AM

PHP is suitable for web development and rapid prototyping, and Python is suitable for data science and machine learning. 1.PHP is used for dynamic web development, with simple syntax and suitable for rapid development. 2. Python has concise syntax, is suitable for multiple fields, and has a strong library ecosystem.

PHP and Frameworks: Modernizing the LanguageApr 18, 2025 am 12:14 AM

PHP remains important in the modernization process because it supports a large number of websites and applications and adapts to development needs through frameworks. 1.PHP7 improves performance and introduces new features. 2. Modern frameworks such as Laravel, Symfony and CodeIgniter simplify development and improve code quality. 3. Performance optimization and best practices further improve application efficiency.

PHP's Impact: Web Development and BeyondApr 18, 2025 am 12:10 AM

PHPhassignificantlyimpactedwebdevelopmentandextendsbeyondit.1)ItpowersmajorplatformslikeWordPressandexcelsindatabaseinteractions.2)PHP'sadaptabilityallowsittoscaleforlargeapplicationsusingframeworkslikeLaravel.3)Beyondweb,PHPisusedincommand-linescrip

How does PHP type hinting work, including scalar types, return types, union types, and nullable types?Apr 17, 2025 am 12:25 AM

PHP type prompts to improve code quality and readability. 1) Scalar type tips: Since PHP7.0, basic data types are allowed to be specified in function parameters, such as int, float, etc. 2) Return type prompt: Ensure the consistency of the function return value type. 3) Union type prompt: Since PHP8.0, multiple types are allowed to be specified in function parameters or return values. 4) Nullable type prompt: Allows to include null values and handle functions that may return null values.

See all articles