0. 目标
安装eolinker 开源版本3.2.1。
本文均以WIN X64环境,绿色安装包来讲解。
1. 安装包准备
本文均已绿色安装包来讲解,eolinker 3.2.1 的基础环境为:
PHP 5.5+ / PHP7+(推荐)
Mysql 5.5+ / Mariadb 5.5+
Nginx(推荐) / Apache
1.1 PHP 5.5+
以 PHP 5.6.33 为例:
http://windows.php.net/download/
在下拉框中选择 PHP5.6+ VC11 X64 Thread Safe。
附下载链接(可能会失效):
http://windows.php.net/downloads/releases/php-5.6.33-Win32-VC11-x64.zip
注意:
1. 必须为Thread Safe版本,否则会缺少php5apache2_4.dll这个动态链接库;
2. 须保证VC11已安装;https://www.microsoft.com/zh-CN/download/details.aspx?id=14632
1.2 APACHE 2.4.x
以 Apache 2.4.29为例:
http://www.apachelounge.com/download/
选择Apache 2.4.29 Win64。
附下载链接(可能会失效):
http://www.apachelounge.com/download/VC15/binaries/httpd-2.4.29-Win64-VC15.zip
注意:
1. 须保证VC15已安装;https://www.microsoft.com/zh-CN/download/details.aspx?id=30679
1.3 MySQL 5.5+
以mysql 5.6.38为例:
https://dev.mysql.com/downloads/mysql/
在页面下方点击 "Looking for the latest GA version?" ,依次选择 5.6.38,Microsoft Windows,Windows(x86, 64-bit),然后下载下方zip包。
附下载链接(可能会失效):
https://cdn.mysql.com//Downloads/MySQL-5.6/mysql-5.6.38-winx64.zip
1.4 eolinker
以eolinker 3.2.1 为例:
https://github.com/eolinker/eoLinker-API-Management-System-OS-3.X
下载eolinker_os_3.2.1.zip
3. 安装、配置及服务启动
绿色版的安装,其实就是解压,修改配置文件,配置环境变量等动作。
3.1 PHP安装及配置
3.1.1 安装
解压 php-5.6.33-Win32-VC11-x64.zip 至工作目录,本文以 D:\eolinker\php 为例。
在path环境变量中添加:
D:\eolinker\php
和
D:\eolinker\php\ext
3.1.2 配置
将 D:\eolinker\php\php.ini-development 备份一份为 D:\eolinker\php\php.ini,
以下内容均在 D:\eolinker\php\php.ini 中修改:
1. 修改
; extension_dir = "ext"
为
extension_dir = "D:/eolinker/php/ext"
2. 修改
;extension=php_curl.dll
为
extension=php_curl.dll
3. 修改
;extension=php_mbstring.dll
为
extension=php_mbstring.dll
4. 修改
;extension=php_mysql.dll
为
extension=php_mysql.dll
5. 修改
;extension=php_mysqli.dll
为
extension=php_mysqli.dll
6. 修改
;extension=php_pdo_mysql.dll
为
extension=php_pdo_mysql.dll
3.1.3 测试安装成果
命令行中输入
php -v
能显示版本号信息即为配置成功,否则请检查环境变量;
若提示xxx.dll未安装,请确认VC11库是否安装。
3.2 Apache安装及配置
3.2.1 安装
解压 httpd-2.4.29-Win64-VC15.zip 至工作目录,本文以 D:\eolinker\Apache24 为例。
3.2.2 配置
以下内容均在 D:\eolinker\Apache24\conf\httpd.conf 中修改:
(1-5点可简化为全局替换 c:/Apache24 为 D:/eolinker/Apache24)
1. 修改
ServerRoot "c:/Apache24"
为
ServerRoot "D:/eolinker/Apache24";
2. 修改
DocumentRoot "c:/Apache24/htdocs"
为
DocumentRoot "D:/eolinker/Apache24/htdocs"
3. 修改
<Directory "c:/Apache24/htdocs">
为
<Directory "D:/eolinker/Apache24/htdocs">
4. 修改
ScriptAlias /cgi-bin/ "c:/Apache24/cgi-bin/"
为
ScriptAlias /cgi-bin/ "D:/eolinker/Apache24/cgi-bin/"
5. 修改
<Directory "c:/Apache24/cgi-bin">
为
<Directory "D:/eolinker/Apache24/cgi-bin">
6. 修改
# ServerName www.example.com:80
为
ServerName www.example.com:8123
注意:
1. 此处为取消注释;
2. 修改端口号为需要对外提供服务的端口号,避免与已有服务冲突。
7. 修改
DirectoryIndex index.html
为
DirectoryIndex index.html index.php index.htm
8. 添加
在httpd.conf最后添加以下三行:
LoadModule php5_module "D:/eolinker/php/php5apache2_4.dll"
AddType application/x-httpd-php .php .html .htm
PHPIniDir "D:/eolinker/php"
注意:
1. 此处添加这三行为让apache支持php;
3.2.3 服务启动
在命令行(不要使用powershell,可能会有错误信息无法显示的问题)中进入D:/eolinker/Apache24/bin,执行:
httpd -k install
安装apache服务,
然后再执行:
net start apache2.4
启动服务
注意:
1. 如果启动报错,提示找不到php5apache2_4.dll,请确认PHP版本;
2. 如果提示确实xxx.dll 请确认VC15是否安装;
3. httpd -k restart 为重启服务命令,在配置文件,或PHP内容有修改后,可通过此命令重新启动;
4. httpd -k uninstall 为删除apache服务。
3.3 MySQL安装及配置
3.3.1 安装
解压 mysql-5.6.38-winx64.zip 至工作目录,本文以 D:\eolinker\mysql-5.6.38 为例。
在path环境变量中添加:
D:\eolinker\mysql-5.6.38\bin
3.3.2 配置
将
D:\eolinker\mysql-5.6.38\my-default.ini
复制为
D:\eolinker\mysql-5.6.38\my.ini
以下内容均在 D:\eolinker\mysql-5.6.38\my.ini 中修改:
1. 修改
# basedir = .....
为
basedir = D:\eolinker\mysql-5.6.38
2. 修改
# datadir = .....
为
datadir = D:\eolinker\mysql-5.6.38\data
3. 修改
# port = .....
为
port = 3306
4. 添加
在文件末尾添加
skip-grant-tables
3.3.3 服务启动
3.3.3.1 mysql服务启动
使用命令行进入
D:\eolinker\mysql-5.6.38\bin
执行
mysqld --install
提示成功,再执行
mysqld -install MySQSL --defaults-file="D:\eolinker\mysql-5.6.38\my.ini"
成功后,再执行
net start mysql
启动mysql服务
在命令行执行
mysql -u root -p
进入数据库,首次进入不需要输入密码
show databases;
查看当前数据库
use mysql;
切换到mysql数据库
UPDATE user SET password=PASSWORD("123456") WHERE user='root';
设置root用户密码为123456
FLUSH PRIVILEGES;
刷新使密码生效
quit;
3.3.3.2 eolinker数据库配置
在命令行执行
mysql -u root -p
使用root用户进入数据库
create database eolinker_test;
创建数据库,名为eolinker_test
use eolinker_test
进入eolinker_test数据库
CREATE USER eo identified BY 'eo123';
创建用户名为eo的用户,密码为eo123
Grant all ON eolinker_test TO eo;
将eolinker_test数据库的所有权限赋予eo
quit;
4. 安装eolinker
解压eolinker_os_3.2.1.zip至工作目录,本文以 D:\eolinker\Apache24\htdocs\eolinker 为例。
命令行执行 httpd -k restart 重启apache服务
浏览器中打开
http://localhost:8123/eolinker
按照提示安装即可。
5. 可能出现的问题
1. VC11的缺失;
安装VC11即可
2. VC15的缺失;
安装VC15即可
3. 安装eolinker提示缺失curl模块:
将 libssh2.dll, php_curl.dll, ssleay32.dll, libeay32.dll 复制到c:\Windows\system32 中,
将 libssh2.dll 复制到 D:\eolinker\Apache24\bin 中,
httpd -k restart 重启apache服务。
6. 类似的工具
http://rapapi.org/org/index.do
http://yapi.qunar.com/
http://doclever.cn/controller/index/index.html