FastAdmin在1.0.0.20180308_beta
中已经新增了一键生成API文档的功能,此功能可以很方便的根据让我们生成API接口的文档,但是在PHP5中某此情况下可能会导致无法使用此功能。
由于此功能使用了PHP中的ReflectionClass
进行分析控制器中的注释和方法,在PHP5中有这样一个BUG会导致在部分情况下产生一个Fatal Error
,导致我们无法生成API文档,通常的情况下报错为:
Fatal error: Cannot use appcommonlibraryEms as Ems because the name is already in use in C:phpStudyWWWfastadminapplicationapicontrollerUser.php on line 6
此BUG只在PHP5中出现,PHP7中不会有此问题,具体请查看BUG说明:
https://bugs.php.net/bug.php?id=66773 https://bugs.php.net/bug.php?id=71079
但我们在PHP5中安装Opcache且启用后,此BUG将不会出现。因为我们建议你如果你使用了PHP5版本,建议你安装启用Opcache
,同时需要启用opcache.enable_cli
。
如何启用Opcache?
因为在PHP5以后都自带Opcache
了,我们只需要启用它即可。
1.如果你使用的是phpStudy,可以直接点击其它选项菜单
->PHP扩展及设置
->PHP扩展
,勾选php_opcache
,然后点击其它选项菜单
->打开配置文件
->php-ini
,搜索opcache.enable
,将opcache.enable
和opcache.enable_cli
都置为1。
2.如果你是在Linux环境,请查找php.ini
所在位置,修改其中的opcache.enable
值。
重启服务后再次使用php think api --force=true
将可正常生成API文档。
希望以上内容对你有所帮助!如果还有其他问题,请随时提问。 各类知识收集 拥有多年CMS企业建站经验,对 iCMS, Fastadmin, ClassCMS, LeCMS, PbootCMS, PHPCMS, 易优CMS, YzmCMS, 讯睿CMS, 极致CMS, Wordpress, HkCMS, YznCMS, WellCMS, ThinkCMF, 等各类cms的相互转化,程序开发,网站制作,bug修复,程序杀毒,插件定制都可以提供最佳解决方案。