1.2.1 手动创建
在Windowns系统下,可以手动创建一个新的项目。
假设目录为: F:\xampp\htdocs\PhalApi
以下是简单的创建操作:
(1)新建项目目录
在./PhalApi目录新建一个自己的项目目录,通常以项目名称命名,如项目MyApp对应:
然后,再分别在里面添加接口目录Api、领域目录Domain、数据源目录Model和通用目录Common,即:
(2)创建访问入口
将./Public/demo目录复制一份为对应项目名称小写的目录,如这里的myapp:
注意!这里需要修改./Public/myapp/index.php和./Public/myapp/checkApiParams.php中的目录:
浏览器访问
在浏览器输入以下链接:
http://localhost/phalapi/public/myapp/
应该可以看到:
12.2 自动生成
在Linux系统下,我们可以使用脚本快速生成一个项目结构,此过程只需要1分钟左右。
简明操作如下:
(1)使用phalapi-buildapp脚本
phalapi-buildapp脚本用于创建项目,进入 ./PhalApi/PhalApi/ 后,可以看到这个脚本。
不过,首先,需要为这个脚本添加执行权限:
$ chmod +x ./phalapi-buildapp
然后,调用脚本创建一个MyApp的项目:
$ ./phalapi-buildapp MyApp
OK!
(2)查看生成的项目及访问
回到 /path/to/PhalApi 目录,你会发现生成了一个MyApp目录,并且里面的文件如下:
$ cd MyApp/
$ tree
.
├── Api
│ └── Default.php
├── Common
├── Domain
├── Model
└── Tests
├── Api
│ └── Api_Default_Test.php
├── Common
├── Domain
├── Model
├── phpunit.xml
└── test_env.php
9 directories, 4 files
在Public目录下,则会有myapp的访问入口:
└── myapp
├── checkApiParams.php
└── index.php
在浏览器访问:
http://dev.phalapi.com/myapp/
可以看到接口结果输出。
(3)执行单元测试
如果安装了PHPUnit,执行一下单元测试,也是通过的!
$ phpunit ./Tests/
PHPUnit 4.3.4 by Sebastian Bergmann.
...
Time: 7 ms, Memory: 5.75Mb
OK (3 tests, 13 assertions)
1.2.3 更多技巧
(1)日记目录需要0777权限
请确保日记目录Runtime拥有写入的权限,可以给0777 。
(2)脚本加执行权限和软链
有本个脚本,需要添加执行权限和软链,便于日后使用:
$ cd /pah/to/PhalApi/PhalApi
$ chmod +x ./phalapi-buildapp
$ ln -s /path/to/phalapi-buildapp /usr/bin/phalapi-buildapp
$ chmod +x ./phalapi-buildsqls
$ ln -s /path/to/phalapi-buildsqls /usr/bin/phalapi-buildsqls
$ chmod +x ./phalapi-buildtest
$ ln -s /path/to/phalapi-buildtest /usr/bin/phalapi-buildtest