PEAR의 코딩 규칙에는 들여쓰기 규칙, 제어 구조, 함수 호출, 함수 정의, 주석, 포함 코드, PHP 태그, 파일 헤더의 주석 블록, CVS 태그, URL 샘플 및 상수 이름 지정이 포함됩니다. 간단한 소개입니다
apt-get install php-pear
pear 설치 채널://pear.php.net/PHP_ArrayOf-0.2.1
pear 다운로드 채널://pear.php.net/ PHP_ArrayOf-0.2.1
PERR PEARR
코딩 규칙에는 들여쓰기 규칙, 제어 구조, 함수 호출, 함수 정의, 주석, 포함 코드, PHP 태그, 파일 헤더 주석 블록, CVS 태그, URL 샘플이 포함됩니다. , 상수 명명의 11가지 측면. 다음은 간단한 소개입니다:
들여쓰기 규칙:
PEAR는 코드를 들여쓰기 위해 4개의 공백이 필요하며 TAB은 사용되지 않습니다. VIM을 사용하는 경우 ~/.vimrc에 다음 설정을 지정하세요.
setexpandtabsetshiftwidth=4set tabstop=4
Emacs/XEmacs를 사용하는 경우 indent-tabs-mode를 nil로 설정해야 합니다.
하지만 저처럼 (X)Emacs를 사용하여 PHP 파일을 편집하고 싶다면 PEAR 코드를 작성할 때 들여쓰기 스타일이 자동으로 조정되도록 PHP-MODE를 설치하는 것이 좋습니다. 또한 많은 훌륭한 기능이 있으며 리소스 목록에서 최신 버전의 PHP-MODE를 다운로드할 수 있습니다.
제어 구조:
여기서 언급된 제어 구조에는 while 스위치 등이 포함됩니다. 제어 구조의 경우 키워드(예: if for ..) 뒤에 공백이 있어야 하고 제어 괄호 뒤에 있어야 함수 호출과 혼동되지 않습니다. 또한 중괄호 {}를 사용해야 합니다. 구문상 선택사항이더라도 최대한 완벽하게. 이렇게 하면 나중에 새로운 코드 줄을 추가해야 할 때 논리적 혼란이나 오류를 방지할 수 있습니다. 다음은 샘플입니다. fIF (((((((((조건 및 1) && (조건 및 2)) {문 1;} Esleif ((조건 3) || (조건 4)) {문 2; } else {statement 3;}
함수 호출: 함수 호출의 경우 함수 이름 및 왼쪽 대괄호(함수 사이에 공백이 있어서는 안 됩니다. 함수 매개변수의 경우 구분된 쉼표와 쉼표 사이에 동일한 공백 구분이 있어야 합니다. 다음 매개변수 사이에는 공백이 없어야 합니다. 다음은 표준 함수 호출입니다.
$result = foo($param1, $param2, $param3); 不规范的写法: $result=foo ($param1,$param2,$param3);$result=foo( $param1,$param2, $param3 );
또한 함수의 반환 결과를 할당하려면 등호와 할당된 값 사이에 공백이 있어야 합니다. 동시에 일련의 관련 할당문인 경우 다음과 같이 정렬할 수 있도록 적절한 공백을 추가합니다.
$result1 = $foo($param1, $param2, $param3); $var2 = $foo($param3); $var3 = $foo($param4, $param5);
함수 정의:
함수 정의는 "One TRUE Brace" 사용자 정의를 따릅니다. :
Rreee위와 같이 선택적 매개변수는 끝에 있는 매개변수 테이블에 있어야 하며 항상 의미 있는 함수 값을 반환하도록 노력해야 합니다.
설명에 대해:
클래스의 온라인 문서가 가능해야 합니다. JavaDoc과 마찬가지로 PHPDoc로 변환되었습니다. PHPDoc도 PEAR 애플리케이션입니다. 자세한 내용은 http://www.phpdoc.de/로 이동하여 클래스의 온라인 문서를 확인하는 것이 좋습니다. 코드를 설명하기 위해 문서화되지 않은 주석을 사용하는 경우 다음과 같이 생각합니다.
문서에 자세히 설명할 필요는 없다고 생각합니다. 그러면 이에 대해 간단한 주석을 작성하는 것이 좋습니다. 주석 형식의 경우 C의 /* */ 및 C++의 //는 좋지만 Perl이나 쉘의 # 주석 방법을 사용하지 마십시오:
코드 포함:
언제든지 클래스 파일에 무조건 포함해야 하는 경우에는 require_once를 사용해야 합니다. 클래스 파일을 조건부로 포함하려면 include_once를 사용해야 합니다. 이렇게 하면 포함하려는 파일이 한 번만 포함되며 이 두 문은 공유됩니다. 동일한 파일 목록이므로 두 가지가 혼동되는 것에 대해 걱정할 필요가 없습니다. require_once에 파일이 포함되면 include_once는 더 이상 동일한 파일을 두 번 포함하지 않으며 그 반대도 마찬가지입니다.
PHP 코드 태그:
항상 <를 사용하세요. ;?php ?>를 사용하면 단순히 c344555b90c740e0d12635e07ea03035가 아닌 PEAR의 호환성을 보장하고 크로스 플랫폼 포팅도 용이하게 할 수 있습니다. 다음 주석 문을 추가해야 합니다.
/* vim: set expandtab tabstop=4 shiftwidth=4: */ // +----------------------------------------------------------------------+ // | PHP version 4.0 | // +----------------------------------------------------------------------+ // | Copyright (c) 1997, 1998, 1999, 2000, 2001 The PHP Group | // +----------------------------------------------------------------------+ // | This source file is subject to version 2.0 of the PHP license, | // | that is bundled with this package in the file LICENSE, and is // | available at through the world-wide-web at | // | http://www.php.net/license/2_02.txt. | // | If you did not receive a copy of the PHP license and are unable to | // | obtain it through the world-wide-web, please send a note to | // | license@php.net so we can mail you a copy immediately. | // +----------------------------------------------------------------------+ // | Authors: Original Author | // | Your Name | // +----------------------------------------------------------------------+ // // $Id$
对于不在PEAR核心代码库中的文件,建议你也在文件的开始处有这样一个类似的注释块,标明版权,协议,作者等等。同时也在第一行加入VIM的MODELINE,这样在VIM中能够保持PEAR的代码风格。
CVS标记:
如上面所展示那样,在每个文件中加入CVS的ID标记,如果你编辑或修改的文件中没有这个标记,那么请加入,或者是替换原文件中相类似的表现形式(如"Last modified"等等)
URL样本:
你可以参照RFC 2606,使用"www.example.com"作为所有的URL样本。
常量命名:
常量应该尽量使用大写,为了便于理解,使用下划线分割每个单词。同时,你应该常量所在的包名或者是类名作为前缀。比如,对于Bug类中常量应该以Bug_开始。
以上是PEAR的编码规则,详细的编码规则可以参考PEAR中的CODING_STANDDARD文件的说明。为了更好地理解这些编码规则,你也可以参考一下现有PEAR核心模块的代码。
推荐学习:php视频教程
위 내용은 PHP에서 배 확장 패키지를 사용하는 방법의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!