PHP 주석 구문 사양 및 명명 규칙에 대한 자세한 설명

코멘트는 코드를 작성하는 과정에서 매우 중요합니다. 좋은 코멘트는 코드를 읽기 쉽게 만듭니다. 코드를 작성할 때 코멘트 사양에 주의를 기울여야 합니다. 필요한 사람은 누구나 참고할 수 있습니다. 그것.

HP 주석 사양

코드를 작성하는 과정에서 주석은 매우 중요합니다. 좋은 주석을 사용하면 코드를 더 쉽게 읽을 수 있습니다.

"PHP는 시작하기 매우 쉬운 언어입니다. 이제 막 시작한 초보자도 에코를 사용하여 몇 분 안에 hello world를 인쇄할 수 있습니다! 하지만 그가 진짜 프로그래머인가요? 진정한 프로그래머가 되려면 일련의 프로그램 작성 표준을 따라야 합니다.”

우리는 종종 일부 함수를 작성하지만 이러한 함수는 우리 자신만이 이해할 수 있고 작성하는 방법조차 모를 수도 있습니다. 그래, 우리는 어떻게 해야 하지? 가장 좋은 방법은 물론 코드에 주석을 추가하는 것입니다.

우리는 주석 작성, C pear PHP 주석 등 다양한 방법에 익숙할 수 있지만, 우리가 사용하는 주요 방법은 # 및 /**/.

#은 짧은 댓글 방식입니다. 변수에 주석을 달거나 메소드를 호출하는 데 사용할 수도 있습니다. /**/입니다. 코드는 있지만 어떻게 사용하나요? 함수의 표준 주석은 어떻습니까?

/**
* @name 名字
* @abstract 申明变量/类/方法
* @access 指明这个变量、类、函数/方法的存取权限
* @author 函数作者的名字和邮箱地址
* @category 组织packages
* @copyright 指明版权信息
* @const 指明常量
* @deprecate 指明不推荐或者是废弃的信息
* @example 示例
* @exclude 指明当前的注释将不进行分析，不出现在文挡中
* @final 指明这是一个最终的类、方法、属性，禁止派生、修改。
* @global 指明在此函数中引用的全局变量
* @include 指明包含的文件的信息
* @link 定义在线连接
* @module 定义归属的模块信息
* @modulegroup 定义归属的模块组
* @package 定义归属的包的信息
* @param 定义函数或者方法的参数信息
* @return 定义函数或者方法的返回信息
* @see 定义需要参考的函数、变量，并加入相应的超级连接。
* @since 指明该api函数或者方法是从哪个版本开始引入的
* @static 指明变量、类、函数是静态的。
* @throws 指明此函数可能抛出的错误异常,极其发生的情况
* @todo 指明应该改进或没有实现的地方
* @var 定义说明变量/属性。
* @version 定义版本信息
*/

주석이 달린 정보는 매우 포괄적이어서 우리가 사용하지 않는 내용이 많을 수 있습니다. 빨간색 부분은 우리가 자주 사용하는 정보입니다.

예: PHP의 몇 가지 일반적인 주석 방법:

1. 파일 주석, 파일 이름, 함수, 작성자 버전 번호 및 기타 정보 소개

/**
* 文件名简单介绍
* 
* 文件功能
* @author 作者
* @version 版本号
* @date 2020-02-02
*/

파일 헤더 템플릿

/** 
*这是一个什么文件 
* 
*此文件程序用来做什么的（详细说明，可选。）。 
* @author   richard<e421083458@163.com> 
* @version   $Id$ 
* @since    1.0 
*/

2. 클래스 주석, 클래스 이름 및 소개

/**
* 类的介绍
* 
* 类的详细介绍（可选）
* @author 作者
* @version 版本号
* @date 2020-02-02
*/

/** 
* 类的介绍 
* 
* 类的详细介绍（可选。）。 
* @author     richard<e421083458@163.com> 
* @since     1.0 
*/ 
class Test  
{ 
}

3. 함수 주석, 함수 함수, 매개변수 소개 및 반환 유형

/**
* 函数的含义说明
* 
* @access public 
* @author 作者
* @param mixed $arg1 参数一的说明 
* @param mixed $arg2 参数二的说明
* @return array 返回类型
* @date 2020-02-02
*/

함수 헤더 주석

/** 
* some_func 
* 函数的含义说明 
* 
* @access public 
* @param mixed $arg1 参数一的说明 
* @param mixed $arg2 参数二的说明 
* @param mixed $mixed 这是一个混合类型 
* @since 1.0 
* @return array 
*/ 
public function thisIsFunction($string, $integer, $mixed) {return array();}

프로그램 코드 주석

1. 주석의 원칙은 문제를 명확하게 설명하는 것입니다. .

2. 여러 문장이 논리 코드 블록으로 사용되며, 이 블록의 주석은 /* */일 수 있습니다.

3. 특정 명령문과 관련된 주석의 경우 줄 끝 주석을 사용할 수 있습니다: //.

/* 生成配置文件、数据文件。*/ 
 
$this->setConfig(); 
$this->createConfigFile(); //创建配置文件 
$this->clearCache();     // 清除缓存文件 
$this->createDataFiles();  // 生成数据文件 
$this->prepareProxys(); 
$this->restart();

PHP 명명 규칙

1. 디렉터리 및 파일

디렉토리에는 소문자 + 밑줄을 사용하세요.
클래스 라이브러리, 함수 파일에는 균일하게 .php라는 접미사가 붙습니다.
클래스의 파일 이름은 모두 네임스페이스에 정의되어 있으며 경로는 네임스페이스의 경로는 클래스 라이브러리 파일의 경로와 일치하며, 클래스 파일 이름은 카멜 케이스(첫 글자는 대문자)로 지정되며, 기타 파일 이름은 소문자 + 밑줄로 지정됩니다. , 카멜케이스 방식(첫 글자는 대문자)을 일률적으로 사용합니다. 2. 함수 및 클래스, 속성 네이밍

클래스 네이밍은 User, UserType 등 카멜 케이스(첫 글자는 대문자)를 사용하며, 접미사는 없습니다. 예를 들어 UserController의 이름은 User

직접 지정해야 합니다. 함수의 이름은 소문자와 밑줄(소문자로 시작)을 사용합니다. 예를 들어 get_client_ip

메서드는 Camel Case(첫 번째)를 사용하여 이름을 지정합니다. 문자는 소문자임), getUserName(메서드에 반환 값이 있는 경우 현재 s(string), i(int ), f(float)와 같은 속성 유형에 대해 첫 번째 문자를 소문자로 사용하는 것이 일반적입니다. b(부울), a(배열) 등)

tableName, 인스턴스와 같은 속성 이름 지정(첫 번째 문자는 소문자)에 카멜 케이스 방식을 사용합니다. (현재 s와 같은 속성 유형에는 소문자를 사용하는 것이 일반적입니다. string), i(int), f(float), b(boolean), a(array) 등)

이중 밑줄 "__"로 시작하는 함수 또는 메서드는 __call 및 __autoload

와 같은 매직 메서드로 사용됩니다. 3.상수 및 구성

상수는 APP_PATH 및 THINK_PATH와 같이 대문자와 밑줄로 이름이 지정됩니다.

구성 매개변수는 url_route_on 및 url_convert와 같이 소문자와 밑줄로 이름이 지정됩니다.

4 데이터 테이블 상자 필드

데이터 테이블 및 필드는 소문자로 되어 있고 밑줄이 그어진 명명 방식을 사용하며 think_user 테이블, user_name 필드와 같이 필드 이름을 밑줄로 시작하지 않도록 주의해야 합니다. 데이터 테이블 필드 이름으로 카멜 표기법과 중국어를 사용하는 것은 권장하지 않습니다.

위 내용은 PHP 주석 구문 사양 및 명명 규칙에 대한 자세한 설명의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!