PHP PSR-1 기본 코드 사양

기본 코드 사양

이 사양은 공유 PHP 코드 간의 높은 수준의 기술적 상호 운용성을 보장하기 위해
코드의 기본 요소에 대한 관련 표준을 공식화합니다.

키워드 "해야 한다"("MUST"), "해서는 안 된다/해서는 안 된다"("MUST NOT"), "필요하다"("필수"),
"할 것이다"("SHALL"), "SHALL NOT"), "SHOULD"), "SHOULD NOT",
"RECOMMENDED", "MAY" ) 및 "OPTIONAL")은 [RFC 2119][]에 자세히 설명되어 있습니다.

개요

---

PHP 코드 파일은 로 시작해야 합니다.

PHP 코드 파일은 BOM 없이 UTF-8로 인코딩되어야 합니다.

PHP 코드에서 은 클래스, 함수, 상수 등과 같은 선언이나 하위 효과(예: 파일 출력 생성 및 .ini 구성 파일 수정 등)를 생성하는 기타 작업만 정의해야 합니다. .) 둘 중 하나만 선택할 수 있습니다.

네임스페이스 및 클래스 는 PSR의 자동 로딩 사양(PSR-0[] 중 하나)을 준수해야 합니다.

클래스 이름 지정은 대문자로 시작하는 StudlyCaps 낙타 표기 규칙을 따라야 합니다.

클래스에 있는 상수의 모든 문자는 대문자여야 하며 단어는 밑줄로 구분해야 합니다

.

메서드 이름은반드시 소문자 CamelCase로 시작하는 CamelCase 명명 규칙을 준수해야 합니다.

파일

---

2.1. PHP 태그

PHP 코드는 긴 태그 또는 = ?> 짧은 출력 태그를 사용해야 하며
다른 사용자 정의 태그를 사용하면 안 됩니다 .

2.2. 문자 인코딩

PHP 코드반드시 BOM 없이 UTF-8 인코딩만 사용할 수 있습니다.

2.3.부작용(부작용)

PHP 파일은 종속성 효과를 생성하지 않는 클래스, 함수 또는 상수와 같은 새 선언만 정의하거나 종속성 효과를 생성하는 논리 연산만 정의해야 합니다. 그러나 그렇게 해서는 안 됩니다. 두 가지를 동시에 가지고 있습니다.

부작용이라는 용어는 클래스,
함수, 상수 등을 직접 선언하지 않고 파일만 포함하여 수행되는 논리적 연산을 의미합니다.

"종속 효과"에는 출력 생성, 직접 요구 또는 포함, 외부 서비스에 연결, ini 구성 수정, 오류 또는 예외 발생, 전역 또는 정적 변수 수정, 파일 읽기 또는 쓰기 등이 포함되지만 이에 국한되지는 않습니다.

다음은 선언과 종속 효과가 포함된 코드인 반대 예입니다.

// 종속성 효과: ini 구성 수정
ini_set('error_reporting', E_ALL);

// 하위 효과: 파일 삽입
include "file.php";

// 하위 효과: 출력 생성
 echo "n";

//함수 선언
function foo()
{
 // 함수 본문
}

다음은 종속성 효과가 생성되지 않는다는 선언만 포함하는 코드의 예입니다.

//함수 선언
function foo()
{
 // 함수 본문 부분
}

// 조건문 **not**은 종속 효과에 속하지 않습니다
if (! function_exists('bar')) {
 function bar()
 {
 // 함수 본문 부분
 }
}

네임스페이스 및 클래스

---

네임스페이스 및 클래스 이름 지정은 [PSR-0][]을 따라야 합니다.

사양에 따르면 각 클래스는 독립적인 파일이며 네임스페이스에는 최상위 조직 이름(공급업체 이름)이라는 하나 이상의 수준이 있습니다.

클래스 이름 지정은 대문자로 시작하는 StudlyCaps Camel Case 명명 규칙을 따라야 합니다.

PHP 5.3 이상 버전용 코드는 반드시 공식 네임스페이스를 사용해야 합니다.

예:

// PHP 5.3 이상 버전
네임스페이스 VendorModel;

class Foo
{
}

5.2.x 및 이전 버전은 의사 네임스페이스 작성을 사용해야 합니다. 이는 관례입니다. Vendor_와 같은 최상위 조직 이름(공급업체 이름)을 클래스 접두사로 사용합니다.

// 5.2.x 및 이전 버전
class Vendor_Model_Foo
{
}

클래스의 상수, 속성 및 메서드

---

여기서 "클래스"는 모든 클래스, 인터페이스 및 재사용 가능한 코드 블록(특성)을 의미합니다.

4.1. 상수

클래스의 상수에 있는 모든 문자 는 대문자여야 하며 단어는 밑줄로 구분됩니다.
다음 코드를 참조하세요:

namespace VendorModel;

class Foo
{
 const VERSION = '1.0';
 const DATE_APPROVED = '2012-06-01';
}

4.2. 속성

클래스의 속성 이름 지정은 대문자로 시작하는 카멜 케이스($StudlyCaps), 소문자로 시작하는 카멜 케이스($camelCase) 또는 밑줄 구분 형식($under_score)을 따를 수 있습니다. 필수로 지정하지는 않지만 어느 방법을 따르든 각 명명 방법은 특정 범위 내에서 일관성을 유지해야 합니다. 이 범위는 전체 팀, 전체 패키지, 전체 클래스 또는 전체 메서드가 될 수 있습니다. 4.3. 방법

메서드 이름은

반드시 소문자로 시작하는 camelCase() 스타일 CamelCase 명명 규칙을 준수해야 합니다.

Github(PizzaLiu)에서 다시 게시

PHP, PSR