11 KiB
PhalApi专业版安装教程
运行环境
PhalApi专业版的运行环境要求如下：
- 操作系统：Windows/Linux/Mac/Ubuntu/CentOS等
- 开发语言：PHP 5.3.3 及以上版本，推荐使用PHP 7
- 数据库：MySQL 5.5 及以上版本
- Web服务器：Nginx/Apache
- 正式服务器配置最低配置：CPU 1核 / 内存 2G / 硬盘空间40G / 带宽1M
官方推荐使用：CentOS 7 + PHP 7 + MySQL 5.6 + Nginx
安装视频
如果浏览器无法播放，请换一个浏览器，或下载mp4到本地播放。或参考以下安装说明。
安装步骤如下。
第1步、上传并解压
第1步、购买授权并获取源项目源代码后，将项目源代码包上传到服务器，并进行解压。假设解压目录为：/www/phalapi-pro。
专业版源代码目录
以专业版2.0为例，源代码压缩包解压后有：
其中，管理后台的源代码，基于vue，前后端分离。
另外，开放平台的源代码，也是基于vue，前后端分离。
温馨提示：标准版不含pro_admin和pro_platform前端源代码，旗舰版提供全部无加密源代码。
第2步、配置Nginx/Apache/xampp/宝塔
第2步、进行Web服务器的配置。
Nginx配置
如果使用的是Nginx，参考以下Nginx配置，配置好重启Nginx。
server
{
listen 80;
server_name open.phalapi.net;
index index.html index.php;
root /www/phalapi-pro/public;
location ~ .*\.(php|php5)?$
{
# fastcgi_pass 127.0.0.1:9000;
fastcgi_pass unix:/var/run/php-fpm/php-fpm.sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
# 管理后台
if (!-e $request_filename) {
rewrite ^/admin/(.*) /admin/index.html;
}
# 开放平台
if (!-e $request_filename) {
rewrite ^/platform/(.*) /platform/index.html;
}
# 静态资源缓存
location ~.*\.(js|css|html|png|jpg)$
{
expires 3d;
}
# 限制上传的PHP文件，都只能是下载，而非执行
location ~* /uploads/.*\.(php|php5)?$
{
}
access_log /var/log/nginx/open.phalapi.net.access.log;
error_log /var/log/nginx/open.phalapi.net.error.log;
}
温馨提示：请把open.phalapi.net换成你自己的域名。
Apache配置
如果使用的是Apache，参考以下配置。目录结构：
htdocs
├── phalapi
└── .htaccess
.htaccess内容：
<IfModule mod_rewrite.c>
RewriteEngine on
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_URI} !^/phalapi-pro/public/
RewriteCond ^/admin/(.*) /phalapi-pro/public/admin/index.html;
RewriteCond ^/platform/(.*) /phalapi-pro/public/platform/index.html;
RewriteRule ^(.*)$ /phalapi-pro/public/$1
RewriteRule ^(/)?$ index.php [L]
</IfModule>
配置好后重启Apache。
xampp配置
如果本地使用的是xampp集成环境，可参考以下安装教程。
假设xampp安装的目录是：D:\xampp。
首先，把项目压缩包复制到D:\xampp\htdocs，然后解压并把目录名称改为：phalapi-pro（目录名称可自行修改）。
配置域名，打开D:\xampp\apache\conf\extra\httpd-vhosts.conf配置文件，在最后添加：
<VirtualHost *:80>
DocumentRoot "D:\xampp\htdocs\phalapi-pro\public"
ServerName open.phalapi.net
ErrorLog "logs/open.phalapi.net-error.log"
CustomLog "logs/open.phalapi.net-access.log" common
</VirtualHost>
域名open.phalapi.net，可自行修改。
为Admin管理后台配置Rewrite规则， 修改..\xampp\apache\conf\httpd.conf ,在Apahce的配置文件httpd.conf中把
#LoadModule rewrite_module modules/mod_rewrite.so
前的#去掉，修改为
LoadModule rewrite_module modules/mod_rewrite.so
<Directory />
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order allow,deny
allow from all
</Directory>
DocumentRoot "D:\xampp\htdocs\phalapi-pro\public"
<Directory "D:\xampp\htdocs\phalapi-pro\public">
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order allow,deny
allow from all
RewriteEngine on
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_URI} !^/phalapi-pro/public/
RewriteCond ^/admin/(.*) /phalapi-pro/public/admin/index.html;
RewriteCond ^/platform/(.*) /phalapi-pro/public/platform/index.html;
RewriteRule ^(.*)$ /phalapi-pro/public/$1
RewriteRule ^(/)?$ index.php [L]
</Directory>
然后，配置本地host，打开C:\Windows\System32\drivers\etc\hosts文件，在最后添加：
127.0.0.1 open.phalapi.net
如果提示hosts文件权限不足，可以使用Switch Hosts软件进行修改，或者参考本地XAMPP虚拟域名配置（配合路由）添加写入权限。
最后，启动xampp里面的pache和MySQL，在浏览器访问安装向导：
http://open.phalapi.net/install/
xampp默认数据库账号是root，密码为空。
宝塔配置
进入宝塔后，点击：【网站】-【添加站点】：
在域名中输入自己的域名，例如：open.phalapi.net，然后点【提交】。
然后将项目压缩包（如phalapi-pro-1.0.zip）上传并解压到刚创建站点的根目录，例如：/www/wwwroot/open.phalapi.net。
# cd /www/wwwroot/open.phalapi.net # 进入网站根目录
# unzip ./phalapi-pro-1.0.zip # 上传后解压
# mv ./phalapi-pro-1.0/* ./ # 把解压后的全部文件移到根目录
这时根目录的文件如下：
回到宝塔，修改open.phalapi.net站点的配置，在【网站目录】-【运行目录】下拉选择public目录，点击保存。
接着，在伪静态中，添加并保存：
# 管理后台
if (!-e $request_filename) {
rewrite ^/admin/(.*) /admin/index.html;
}
# 开放平台
if (!-e $request_filename) {
rewrite ^/platform/(.*) /platform/index.html;
}
如图：
绑定域名后，即可访问，进入安装向导。
补充，如果宝塔使用的是Apache，可参考以下配置：
<IfModule mod_rewrite.c>
RewriteEngine on
RewriteBase /
Rewritecond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_URI} ! ^/ phalapi-pro/ public/
Rewritecond ^ / admin/ ( .*) / phalapi-pro/public/admin/index.html;
Rewritecond ^/platform/ ( .*) /phalapi-pro/public/platform/index.html;
RewriteRule ^( .*)$ / phalapi-pro/public/$1
RewriteRule ^( / )?$ index.php[L]
</工fModule>
IIS参考配置
为管理后台添加Rewirte规则，以便管理后台能正常访问。
<rewrite>
<rules>
<rule name="Imported Rule phalapi-pro-admin" stopProcessing="true">
<match url="^/admin/(.*)" />
<conditions>
<add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true"/>
<add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true"/>
</conditions>
<action type="Rewrite" url="/admin/index.html" appendQueryString="true" />
</rule>
</rules>
</rewrite>
第3步、安装向导
安装地址：http://你的域名/install
或者打开首页：http://你的域名/，点击进入安装向导。
第3步、在安装之前，先手动执行以下脚本添加必要的文件和目录权限。
$ ./bin/install_check.sh
start to check ...
check ok!
如果无法在Windows环境上执行此脚本，影响不大，可以在安装向导的引导下手动添加目录权限。
在浏览器访问（注意，域名需要更换成自己的域名或IP地址）：
http://open.phalapi.net/install/
进入安装向导后，同意安装。
检测通过后，下一步。
根据表单，填写数据库的相关配置，以及管理员的账号和密码。下一步。
温馨提示：重点修改你的项目名称、你的数据库连接、管理员登录密码。
安装成功。
如果安装失败，请留意错误提示信息。通常是数据库账号密码错误，或者缺少目录写入权限，此时可尝试重新安装。如果问题尚未解决，可联系我们。
如果重复安装，会看到以下提示：
若需要重新安装，请手动删除./runtime/_install.lock文件。
第4步、计划任务配置
通过crontab -e，添加以下计划任务：
# PhalApi Pro 接口测试
*/1 * * * * php /path/to/phalapi-pro/bin/test/run_test_sample.php > /dev/null
# PhalApi Pro 计划任务
*/1 * * * * php /path/to/phalapi-pro/bin/run_task.php > /dev/null
# PhalApi Pro 应用统计
10 0 * * * php /path/to/phalapi-pro/bin/admin/run_app_daily_stat.php >> /dev/null
其中，需要把/path/to/phalapi-pro换成你当前的服务器路径。
第5步、安装后请记得
安装后，请记得把install安装程序删除，避免被重复或恶意重装。
安装后，请确保./runtime目录有写入权限，以便可以纪录和查看文件日志。
第6步、开始使用
成功安装后，便可开始使用和进行项目开发。