安装

安全前提

首先请使用php -v 命令查看您默认的PHP版本，php-m 查看当前已经安装的扩展，因为当前项目是运行在默认的PHP版本上的， 比如您最开始安装过PHP7.3并且又安装了扩展，但是您为了运行这个PHP工程，又安装了PHP8，但还是跑不起来！

首先请使用php -v 命令查看您默认的PHP版本，php-m 查看当前已经安装的扩展，因为当前项目是运行在默认的PHP版本上的， 比如您最开始安装过PHP7.3并且又安装了扩展，但是您为了运行这个PHP工程，又安装了PHP8，但还是跑不起来！

首先请使用php -v 命令查看您默认的PHP版本，php-m 查看当前已经安装的扩展，因为当前项目是运行在默认的PHP版本上的， 比如您最开始安装过PHP7.3并且又安装了扩展，但是您为了运行这个PHP工程，又安装了PHP8，但还是跑不起来！

重要的事情一定要强调！

环境要求

 * 安装Apache或者NGINX服务器
 * 安装PHP，版本 >= 8.0
 * 安装PHP扩展fileinfo opcache redis imagemagick exif
 * 开发环境下关闭禁用PHP函数exec、putenv、proc_open、proc_get_status、pcntl_signal[如果存在]

如果遇到configure: error: Package requirements (libzip ＞= 0.11 libzip != 1.3.1 libzip != 1.7.0) 错误，请参考：

官网下载地址 wget https://libzip.org/download/libzip-1.3.2.tar.gz

卸载自身的libzip

yum remove libzip

下载

wget https://libzip.org/download/libzip-1.3.2.tar.gz
tar xvf libzip-1.3.2.tar.gz
cd libzip-1.3.2
./configure && make && make install

查看libzip位置

[root@VM-8-9-centos php-7.4.28]# whereis libzip
libzip: /usr/local/lib/libzip.la /usr/local/lib/libzip.a /usr/local/lib/libzip.so

配置libzip库，使configure可以找到它

export PKG_CONFIG_PATH="/usr/local/lib/pkgconfig/"

请确保您的服务器里面存在php zip扩展

安装包下载

安装包可以在`GItee`或者GITHUB进行下载ZIP压缩包，也可以使用git clone命令克隆到本地即可
https://gitee.com/meystack/swiftadmin/ 请务必点击Star支持，点Star会保佑你正常安装成功，否则会出现BUG

开始安装

推荐环境

现在市面上很多PHP的环境，经过测试大多数环境，在易用性、运维程度上，推荐大家使用宝塔面板，最好在Linux下开发是最方便的

安装详情

1、首先将本框架直接clone到你本地,或者直接下载

 * git clone https://gitee.com/meystack/swiftadmin.git
 * 请使用宝塔面板或其他PHP集成环境
 * 安装Apache或者NGINX服务器
 * 安装PHP，版本 >= 8.0
 * 安装PHP扩展fileinfo opcache redis imagemagick exif
 * 开发环境下关闭禁用PHP函数exec、putenv、proc_open、proc_get_status、pcntl_signal[如果存在]

2、Windows环境下启动开发服务

找到根目录下的Windows.bat文件，双击执行该文件即可启动服务。

3、Linux环境下启动开发服务

执行命令：php start.php start        # 启动开发服务
执行命令：php start.php stop         # 停止开发服务
执行命令：php start.php restart      # 重启开发服务
守护进程：php start.php start -d     # 启动守护进程 一般为生产环境/修改文件后无法自动重载

注：当前默认只有app、config文件夹下文件内容被修改后才会自动重启，全局监听方案，请参考开发文档

4、打开浏览器输入网址，访问项目

http://localhost:8787/              # 访问项目执行安装

5、安装完毕后，访问后台URL登录系统

http://localhost:8787/manage        # 登录后台/生产环境下可自行修改后台地址

小皮面板

如果你使用小皮本地PHP环境运行的话，首先是需要你将php文件夹设置到环境变量，比如你的PHP安装路径为C:\phpstudy_pro/php8.0

那么这时候需要你将C:\phpstudy_pro/php8.0加入到Windows系统环境变量里面，否则你在终端CMD下 使用php -v 是获取不到的 提示找不到命令

另外需要注意的是，本框架依赖于Redis扩展服务器，所以你需要确保小皮面板安装redis服务器，更更更需要注意的是，默认小皮面板安装Redis服务器后，他默认是不启动的

所以需要你启动小皮面板下的Redis服务器，所以需要你启动小皮面板下的Redis服务器，所以需要你启动小皮面板下的Redis服务器，

服务器部署

部署项目我们需要使用NGINX进行反向代理操作，如果您使用Apache的话可以搜索下Apache的反向代理规则，建议您使用运维面板操作，更方便一些！

Nginx部署

使用Nginx部署可以很方便的实现均衡负载，以及SSL的配置，能够让多个webman共用80、443端口，通过域名区分不同站点，实现单台服务器部署多个站点

upstream swiftadmin {
    server 127.0.0.1:8787;
    keepalive 10240;
}

server {
  server_name 站点域名;
  listen 80;
  access_log off;
  root /www/swiftadmin/public;

  location ^~ / {
      proxy_set_header X-Real-IP $remote_addr;
      proxy_set_header Host $host;
      proxy_set_header X-Forwarded-Proto $scheme;
      proxy_http_version 1.1;
      proxy_set_header Connection "";
      if (!-f $request_filename){
          proxy_pass http://swiftadmin;
      }
  }
}

宝塔部署

启动项目

在Linux下请在根目录使用php start.php start来启动项目，如果需要后台运行请增加 -d参数 php start.php start -d

我们建议您使用运维面板安装supervisord（进程守护管理器）来运行项目。

bt0.png

1、首先建立一个web站点，如下图：

bt1.png

2、然后绑定静态资源到public文件夹

bt2.png

3、开启反向代理

bt3.png

其他如Apache部署swiftadmin项目，如果使用运维面板来处理，步骤是一样的。更多细节需要您熟悉网站的搭建才可以！

常见问题

1、启动安装出现500错误，因只在宝塔面板下做的开发，没有测试过其他的PHP集成环境；

500错误一般都是配置的问题或者缺少扩展你可以直接在apache或者nginx下查看error的日志信息，或者直接在根目录下添加.env文件（如果未安装的情况下），开启debug调试模式即可！

2、提示控制器错误？

默认后台的控制，多级控制器采用 / 符号链接，比如后台用户控制器为 /system/Admin/index

3、安装完成后打开直接404错误？

我们默认没有启用自动路由，官方也不建议安装自动路由插件，所以请使用http://127.0.0.1:8787/index来访问前端页面， 比如您的控制器在app/index/controller/Ben.php 里面有一个叫做fire的函数，那么您的访问路径为http://127.0.0.1:8787/index/ben/fire

最后更新时间：2023-08-08 22:22:0517109
https://doc.swiftadmin.net/help/3.html