낭망글루 : 태그

태그 : php

2009/02/06 php] manual 중 Userland Naming GuideUserland Naming Guide Table of Contents Global Namespace Rules
2009/02/03 memo/php] from zend coding convention
2009/01/31 memo/php] zend framework screencast summary [4]
2009/01/02 php/framework] RESTful PHP Framework 'DIY' [1]

php 태그와 관련된 다른 이글루의 글 보기

2009년 02월 06일

php] manual 중 Userland Naming GuideUserland Naming Guide Table of Contents Global Namespace Rules

from. http://www.php.net/manual/kr/userlandnaming.php

사용자 네이밍 가이드

목차

전역 이름 공간

규칙

다음은 좋은 결과를 위해 사용자의 PHP 코드 내 식별자로서 이름을 선택하는 방법에 대한 가이드이다. 전역 공간에 심볼을 생성하게 될 코드 내에서 어떤 이름을 선택할 때, 다음의 가이드라인을 고려하는 것은 미래의 PHP 코드에서 당신의 심볼과의 충돌을 방지하는데 중요한 역할을 할 것이다.

전역 이름 공간

전역 이름 공간에서 다룰 코드 구조의 개요는 다음과 같다.

functions 함수

classes 클래스

interfaces 인터페이스

constants ( not class constants ) 상수 (클래스 상수는 아님)

variables defined outside of functions/methods (함수나 메소드 밖에서 정의된 변수)

규칙

다음은 PHP 프로젝트 자체적으로 새로운 지시자의 명명에 대한 개요이다. 공식적인 가이드는 CODING STANDARDS 를 참고할 것.

PHP 는 최고 레벨의 이름공간을 소유하지만, 명백한 충돌을 피하면서 괜찮은 표현의 이름을 찾으려고 시도한다.

함수명은 단어 사이에 밑줄을 사용하고, 클래스명은 낙타 명명법을 사용한다(구버젼의 경우 예외가 존재함).

확장(패키지)의 이름을, 확장에 대한 전역 이름의 prefix;접두어 로 사용한다. (과거에는 꽤 많은 예외가 있었음)
예를 들면,

curl_close()
mysql_query()
PREG_SPLIT_DELIM_CAPTURE
new DOMDocument()
strpos() (과거의 예외임)
new SplFileObject()

iterator 와 exception 은 단순하게 접미어로 사용한다.
ArrayIterator
LogicException

PHP 는 __ (밑줄 2개)로 시작하는 모든 심볼을 magical 로 사용한다. 그러므로, 사용자는 기문서화된 magical 기능을 사용할 것이 아니라면, 사용자 심볼로 __ 로 시작하는 심볼을 사용하지 말 것을 권고한다.
예를 들면,

__get()
__autoload()

팁

미래를 대비한 코드를 작성하고자 한다면, 일상적이지 않은 3~4 문자의 접두어나 접미어를 사용할 것을 권고한다. 또한, 다른 사용자 코드와의 충돌을 대비하려면, 사용하려는 접두어/접미어가 여타 프로젝트에서 사용 중인지 확인한 후, 적절한 방법으로 사용중임을 알리기를 권한다.

예를들면,