PHP 주석 구문 사양 및 명명 규칙에 대한 자세한 설명
- jacklove원래의
- 2018-06-29 17:43:351859검색
코드를 작성하는 과정에서 주석은 매우 중요합니다. 좋은 주석은 코드를 읽기 쉽게 만듭니다. 코드를 작성할 때 주석 사양에 주의해야 합니다. 필요한 것 친구는
HP 주석 사양
을 참조할 수 있습니다. 주석은 코드를 작성하는 과정에서 매우 중요합니다. 좋은 주석은 코드를 더 읽기 쉽게 만들 수 있습니다. 코드를 작성할 때 주석 사양에 주의해야 합니다.
"PHP는 시작하기 매우 쉬운 언어입니다. 초보자도 echo를 사용하여 몇 분 이내에 hello world를 인쇄할 수 있습니다! 하지만 그가 진짜 프로그래머인가요? 프로그래머를 어떻게 정의합니까? ? 만약 진정한 프로그래머가 되고 싶다면 일련의 프로그램 작성 표준을 따라야 합니다.”
우리는 종종 일부 함수를 작성하지만 이러한 함수는 우리 자신만이 이해할 수 있고, 시간이 지나면 어떻게 작성하는지조차 모를 수도 있습니다. .네, 어떻게 해야 할까요? 가장 좋은 방법은 물론 코드에 주석을 추가하는 것입니다.
우리는 주석 작성, C pear PHP 주석 등 다양한 방법에 익숙할 수 있지만, 우리가 사용하는 주요 방법은 # 및 /**/.
#은 짧은 댓글 방식입니다. 변수에 주석을 달거나 메소드를 호출하는 데 사용할 수도 있습니다. /**/입니다. 코드는 있지만 어떻게 사용하나요? 함수의 표준 주석은 어떻습니까?
/**
* @name name
* @abstract는 변수/클래스/메서드를 선언합니다.
* @access는 이 변수, 클래스, 함수/메서드에 대한 액세스 권한을 지정합니다.
* @author 함수 작성자의 이름과 이메일 주소
* @ 카테고리는 패키지를 구성합니다
* @copyright는 저작권 정보를 지정합니다
* @const는 상수를 지정합니다
* @deprecate는 더 이상 사용되지 않거나 더 이상 사용되지 않는 정보를 지정합니다
* @example 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 */
함수 헤더 comments
/**
* 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라는 접미사가 붙습니다.
클래스의 파일 이름은 모두 네임스페이스에 정의되어 있습니다. , 네임스페이스의 경로는 클래스 라이브러리 파일의 경로와 일치합니다. 클래스 파일 이름은 카멜 표기법(첫 글자는 대문자)으로 지정하고, 기타 파일 이름은 소문자 + 밑줄로 지정합니다. 일관성이 있으며 클래스 파일 이름은 Camel Case(첫 글자는 대문자)로 지정됩니다.
2. 함수, 클래스 및 속성 명명은 User, UserType과 같이 Camel Case(첫 글자는 대문자)를 사용합니다. . 기본적으로 접미사는 필요하지 않습니다. 예를 들어 UserController의 이름은 User로 직접 지정해야 합니다.
함수 이름은 소문자로 시작하며, 예를 들어 get_client_ip
속성 이름에는 tableName, 인스턴스(현재 첫 글자는 소문자를 사용하는 것이 관례입니다)와 같이 카멜 표기법(첫 글자는 소문자)을 사용합니다. 속성) s(문자열), i(int), f(float), b(부울), a(배열) 등과 같은 유형)
이중 밑줄 "__"로 시작하는 함수 또는 메소드는 매직 메소드로 사용됩니다. , __call 및 _ _autoload
3. 상수 및 구성
상수 이름은 APP_PATH 및 THINK_PATH와 같이 대문자와 밑줄로 명명됩니다.
구성 매개변수는 url_route_on 및 url_convert와 같이 소문자와 밑줄로 명명됩니다.
4 데이터 테이블 상자 필드
데이터 테이블과 필드는 소문자로 명명됩니다. 필드 이름은 밑줄로 시작해서는 안 됩니다(예: think_user 테이블 및 user_name 필드). 데이터 테이블 필드 이름으로 카멜 표기법과 중국어를 사용하는 것은 권장되지 않습니다.
관심을 가질 수 있는 기사:
php 언어 주석, 한 줄 주석 및 여러 줄 주석의 관련 콘텐츠
소스 코드를 통해 Laravel 종속성 주입 관련 내용을 구문 분석
위 내용은 PHP 주석 구문 사양 및 명명 규칙에 대한 자세한 설명의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!