# 部署安装
# 基础信息
# 下载
https://gitee.com/likeadmin/likeadmin_php
# 环境要求
# 服务端
| 运行环境 | 要求版本 | 推荐版本 |
|---|---|---|
| PHP | >=8.0 | 8.0 |
| Mysql | >=5.7 | 5.7 |
| nginx 或 apache | 无限制 | - |
# 前端
| 运行环境 | 要求版本 | 推荐版本 |
|---|---|---|
| Node.js | >=14.18.1 | 14.18.1 |
# 宝塔面板部署-1-推荐使用
强烈正式环境推荐使用宝塔面板部署项目，让部署更方便，减少部署出现问题。
# 服务器环境设置
- 步骤1:点击【软件商店】-【运行环境】，安装Nginx、MySQL、PHP-8.0。其中Mysql选择5.7版本。
提示
安装软件的时候，使用极速安装，避免出现一些环境引起的问题。
- 步骤2:点击【软件商店】-【已安装】，找到PHP-8.0，然后点击【设置】-【安装扩展】，【安装】fileinfo扩展，【安装】redis扩展。
# 站点部署
步骤1:下载likeadmin压缩包，解压到宝塔面板/www/wwwroot目录。
警告
注意项目目录及子目录用户要为www！如果后续步骤出现问题，重新设置一下项目目录及子目录用户为www。
步骤2:点击【网站】-【PHP项目】-【添加站点】，【域名】项填好已解析到本服务器的域名，【根目录】选择上一步解压好的项目目录的server目录，数据库选择【MySQL】，【数据库帐号】项设置好帐号密码，【PHP版本】选择【PHP-80】，点击【提交】。
警告
站点目录要选择server，请勿选择public，选择public会导致宝塔生成配置错误，等后面设置修改回来也无济于事，只能删除站点新添加。
步骤3:保存好数据库名、用户、密码，后续步骤需要用到。
步骤4:找到网站，点击【设置】-【SSL】-【Let's Encrypt】-【文件验证】-【选择域名】-【申请】，申请SSL证书。
步骤5:点击【网站目录】-【运行目录】选择"/public"，点击【保存】。
步骤6:点击【伪静态】-选择【thinkphp】，点击【保存】。
# 程序安装
步骤7:访问设置的网站，进入程序安装界面，点击【我已阅读同意】。
步骤8:程序进入检测部署，如果出现【重新检测】，请按环境要求重新设置环境，然后点击【重新检测】。如果环境检测通过，直接点击【继续】。
步骤9:按步骤3保存的数据库信息设置好数据库，然后设置后台管理员帐号密码，点击【继续】。
步骤10:程序安装中，完成以后，可以点击【进入管理平台】，使用安装设置的帐号密码登录即可。
# 定时任务
提示
定时任务有多种设置方式，选择其中一种即可。
# URL方式-1（推荐）
点击【计划任务】，设置任务类型为 【访问URL】、填写任务名称、执行周期设置为【N分钟】【1分钟】，填写以下shell的命令。，其中URL地址为"https://域名/crontab"，请以项目实际域名为准，然后【添加任务】。 
# 脚本方式-2
点击【计划任务】，设置任务类型为 【Shell脚本】、填写任务名称、执行周期设置为【N分钟】【1分钟】，填写以下shell的命令。，其中命令中的目录"/www/wwwroot/项目/server/think"为实际项目server目录中的think文件路径，然后【添加任务】。
php80 /www/wwwroot/项目/server/think crontab
# PhpStudy部署-2
注意
大部分windows系统环境使用PHP8会缺少依赖，请先按文档 检测环境。
# 检测环境
- 步骤1: 在使用之前，我们下检查一下php8是否存在环境问题。 按Win键+R，打开windows命令终端，输入命令进入phpStudy的php8目录，命令以实际安装的目录。输入命令查看php版本，如果出现以下蓝色方框警告提示，说明环境有问题。
cd C:\phpstudy_pro\Extensions\php\php8.0.2nts
php -v
- 步骤2: 打开微软官网： https://visualstudio.microsoft.com/zh-hans/downloads/，网页拖动到最底部，点击【其他工具、框架可发行组件】，展开后，找到【Microsoft Visual C++ Redistributable for Visual Studio……】，点击【下载】，下载完安装组件即可。
- 步骤3: 按Win键+R，再次打开windows命令终端，输入命令进入php8目录，命令以实际安装的目录。输入查看php版本，出现以下蓝色方框信息，说明环境已没问题。
cd C:\phpstudy_pro\Extensions\php\php8.0.2nts
php -v
# 源码下载
- 步骤1: 从gitee下载源码包： https://gitee.com/likeadmin/likeadmin_php
- 步骤2: 下载并解压源码。
# 部署安装
步骤1: 打开phpStudy，点击【启动】。
步骤2: 【网站】-【创建网站】，填写域名，设置根目录为解压源码的server/public目录，勾上同步host，选择PHP版本为8.0.x。
步骤3: 点击【伪静态】，填写伪静态信息，点击【确定】。
提示
使用apache省略此步骤
if (!-e $request_filename)
{
rewrite ^/(.*)$ /index.php?s=$1 last;
break;
}
- 步骤4: 点击【网站】-【管理】-【打开网站】，即可进入likeadmin的安装界面。
- 步骤5: 进入likeadmin的安装界面，点击【我已阅读并同意】。
- 步骤6: 然后填写数据库信息，超级管理员的账号密码。点击【继续】，如果在这一步安装报错，请仔细检测信息是否填写正确。phpStudy默认mysql超级管理员账号为root，密码root。如果不正确，可在phpStudy的【数据库】重新设置。
- 步骤7: 安装成功以后，点击【进入管理平台】，即可进入管理后台。
# 登录入口
管理后台： http://域名/admin
# docker部署-3
likeadmin内置docker-compose，支持一句命令运行项目，只需安装docker，不需要安装任何环境。
# 按需配置
如果想更改项目域名，可以更改docker/config/nginx/conf.d/www.likeadmin.host.conf文件，本地部署建议不更改。如果更改了域名，需要做域名解析。 
一般情况下，大多数电脑或服务器都为X86架构，不需要更改docker镜像。如果你运行项目的电脑或服务器是ARM架构，比如说Mac的m1m2芯片电脑，或者树莓派等，需要更改docker-compose.yml配置的Mysql镜像。 打开docker/docker-compose.yml文件，找到Mysql镜像，将Mysql镜像更改为ARM架构。 
在运行之前，确保docker各容器的端口没有被占用，否则无法运行，可以在admin_php/docker/docker-compose.yml文件中，查看或更改各容器端口。 
在linux环境下运行，安装可能会出现权限不足等问题，需要修改admin_php/docker/docker-compose.yml的用户权限配置， 去掉"#"，使用用户权限配置。
警告
其它环境请勿更改。
# 部署安装
- 步骤1: 从 https://www.docker.com/下载安装docker，然后运行docker。 打开终端，在admin_php/docker目录下运行命令，启动容器组。
docker-compose -p likeadmin up -d
- 步骤2: 在浏览器打开部署的域名，没有更改的话，默认为 http://www.likeadmin.host/，即可进入likeadmin的安装界面。
- 步骤3: 进入likeadmin的安装界面，点击【我已阅读并同意】。
- 步骤4: 然后填写数据库信息，超级管理员的账号密码。点击【继续】，如果在这一步安装报错，请仔细检测信息是否填写正确。docker数据库主机填写likeadmin-mysql，默认Mysql超级管理员账号为root，密码root。
提示
因为docker之间的网络通讯使用容器名称作为网络地址，安装填写的Mysql主机也是为了PHP容器与Mysql容器通讯，所以数据库主机需要填写Mysql的容器名称。
- 步骤5: 安装成功以后，点击【进入管理平台】，即可进入管理后台。
# 其他操作
# 停止运行项目
在admin_php/docker目录下运行命令。
docker-compose -p likeadmin down
# 重启nginx
docker exec -it likeadmin-nginx nginx -s reload
# 通用部署-4
如果你非常熟悉PHP项目的部署安装，可以参考一下信息部署项目。不熟悉可参考其他部署方式。
# 项目入口
项目入口目录：server/public
项目入口文件：server/public/index.php
# nginx配置
nginx全配置
server {
listen 80;
server_name demo.likeadmin.cn;
access_log /logs/demo.likeadmin.cnt_access_nginx.log;
error_log /logs/demo.likeadmin.cn_error_nginx.log;
client_max_body_size 5M;
location / {
root likeadmin/server/public;#入口文件目录
index index.html index.htm index.php;
if (!-e $request_filename)
{
rewrite ^/(.*)$ /index.php?s=$1 last;
break;
}
}
location ~ /.*\.php/ {
rewrite ^(.*?/?)(.*\.php)(.*)$ /$2?s=$3 last;
break;
}
error_page 500 502 503 504 /50x.html;
location = /50x.html {
root /var/www/html;
}
location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME likeadmin/server/public$fastcgi_script_name; #入口文件目录
include fastcgi_params;
}
location = /favicon.ico {
log_not_found off;
access_log off;
}
}
nginx伪静态
if (!-e $request_filename)
{
rewrite ^/(.*)$ /index.php?s=$1 last;
break;
}
# apache配置
apache伪静态
<IfModule mod_rewrite.c>
Options +FollowSymlinks -Multiviews
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]
</IfModule>
# 访问地址
部署安装以后管理后台入口地址： http://域名/admin