Skip to content

Latest commit

 

History

History
54 lines (35 loc) · 1.53 KB

《PHP扩展开发》-协程-开发规范.md

File metadata and controls

54 lines (35 loc) · 1.53 KB

开发规范

仓库地址

在开始开发之前,很有必要先说一下开发的规范问题。

1、全局PHP扩展函数的声明都放在文件php_study.h里面。例如:

PHP_FUNCTION(test);

2、全局PHP扩展函数以及扩展方法的参数声明放在study_*.ccstudy.cc里面。

3、没有别名的全局PHP扩展函数的实现放在study.cc里面,有别名的全局PHP扩展函数的实现放在对应的study_*.cc里面。

例如,study_coroutine_create的别名是Study\Coroutine::Create

4、扩展方法声明放在相应的study_*.cc文件里面,并且声明为static类型。例如:

static PHP_METHOD(study_coroutine, test);

5、头文件的引入关系如下:

study_*.cc 引入 对应的 study_*.h
study_*.h 引入 php_study.h和需要的include/*.h
study.cc 引入 php_study.h
php_study.h 引入 php内核提供的头文件
php_study.h 引入 include/study.h
include/study.h 引入 标准库函数
src/*.c 引入 对应的/include/*.h
include/*.h 按需引入 其他的include/*.h

6、只在项目根目录下的study_*.cc文件里面使用Zend API,不在src目录的代码里面使用Zend API

7、为了防止重复引入头文件,增加如下条件编译。例如,在study.h头文件里面写入:

#ifndef STUDY_H_
#define STUDY_H_


#endif /* STUDY_H_ */

注意宏的命名规范。

(待补充)

下一篇:整理文件