eolinker开源版本地部署教程

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. 修改

为

4. 修改

ScriptAlias /cgi-bin/ "c:/Apache24/cgi-bin/"

为

ScriptAlias /cgi-bin/ "D:/eolinker/Apache24/cgi-bin/"

5. 修改

为

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