PEAR 编写规范.docxVIP

PEAR 编写规范 目录  TOC \o 1-3 \h \z \u  HYPERLINK \l _Toc307567799 PEAR 编写规范  PAGEREF _Toc307567799 \h 1  HYPERLINK \l _Toc307567800 缩进  PAGEREF _Toc307567800 \h 1  HYPERLINK \l _Toc307567801 控制结构  PAGEREF _Toc307567801 \h 2  HYPERLINK \l _Toc307567802 函数调用  PAGEREF _Toc307567802 \h 3  HYPERLINK \l _Toc307567803 函数定义  PAGEREF _Toc307567803 \h 4  HYPERLINK \l _Toc307567804 注释  PAGEREF _Toc307567804 \h 5  HYPERLINK \l _Toc307567805 包含代码  PAGEREF _Toc307567805 \h 5  HYPERLINK \l _Toc307567806 PHP 代码标记  PAGEREF _Toc307567806 \h 6  HYPERLINK \l _Toc307567807 使用 CVS  PAGEREF _Toc307567807 \h 7  HYPERLINK \l _Toc307567808 命名约定  PAGEREF _Toc307567808 \h 9  HYPERLINK \l _Toc307567809 Classes  PAGEREF _Toc307567809 \h 9  HYPERLINK \l _Toc307567810 函数和方法  PAGEREF _Toc307567810 \h 9  HYPERLINK \l _Toc307567811 常数  PAGEREF _Toc307567811 \h 10  HYPERLINK \l _Toc307567812 全局变量  PAGEREF _Toc307567812 \h 10  HYPERLINK \l _Toc307567813 预定义的值 true、false 和 null  PAGEREF _Toc307567813 \h 10  缩进 缩进使用4个空格，而不是 tab。如果你使用 Emacs 编辑 PEAR 代码，你应该设置 indent-tabs-mode 为 nil。下面是一个 mode hook 的示例，用于设置 Emacs 符合缩进标准（你必须确保在编辑 PHP 文件时，这些设置发生作用）： (defun php-mode-hook () (setq tab-width 4 c-basic-offset 4 c-hanging-comment-ender-p nil indent-tabs-mode (not (and (string-match /\\(PEAR\\|pear\\)/ (buffer-file-name)) (string-match \.php$ (buffer-file-name)))))) 这里是同等效果的 vim 规则： set expandtab set shiftwidth=4 set softtabstop=4 set tabstop=4 控制结构 控制结构包含 if、for、while、switch 等。这里有一个 if 语句的示例和一个 switch 语句的示例： if 语句的示例： if ((condition1) || (condition2)) { action1; } elseif ((condition3) (condition4)) { action2; } else { defaultaction; } ? switch 语句的示例： switch (condition) { case 1: action1; break; case 2: action2; break; default: defaultaction; break; } ? 控制语句应该在控制关键词和开始的圆括号之间应该有一个空格，以此和函数调用进行区别。 强烈建议你总是使用花括号将控制结构各部分标识出来。即使是在技术上可以不使用花括号的地方。这可以增加代码的可读性