如何在MacOS开发环境中安装Logiks Framework

前置依赖确认 #

安装前需保证你的开发服务器满足以下基础要求：

• 服务器操作系统：推荐Linux主流发行版（Ubuntu 20.04+/CentOS 7+），也支持Windows Server
• Web服务：Apache 2.4+ 或 Nginx 1.18+
• PHP版本：7.4 ~ 8.1 （Logiks暂不支持8.2及以上版本，避免兼容性异常）
• 必开PHP扩展：curl、gd、mbstring、mysqli、pdo、zip、xml
• 数据库：MySQL 5.7+/MariaDB 10.3+，轻量场景也可使用SQLite

服务器端安装操作步骤 #

步骤1：获取安装包并上传部署 #

你可以任选一种方式获取Logiks安装包：

• 下载官方稳定版压缩包，通过SFTP从Mac上传到服务器的Web根目录（默认通常为/var/www/html），执行解压命令：unzip logiks-stable.zip -d logiks
• 在服务器端直接通过git拉取官方最新开发版，进入Web根目录后执行对应克隆命令即可

步骤2：配置目录权限 #

Linux服务器需要给Logiks目录配置Web运行用户的读写权限，执行以下命令：

chmod -R 755 /var/www/html/logiks
chown -R www-data:www-data /var/www/html/logiks

注：如果你的Web服务运行用户不是www-data，替换为对应的用户即可，例如apache、nginx

步骤3：配置Web服务规则 #

Apache环境配置

• 先确认mod_rewrite扩展已开启，未开启的话执行命令：a2enmod rewrite
• 编辑Apache站点配置文件，添加目录权限规则：

return (<Directory /var/www/html/logiks>
    Options Indexes FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>
)

• 重启Apache生效配置：systemctl restart apache2

Nginx环境配置

• 编辑Nginx站点配置文件，添加伪静态规则：

location /logiks {
try_files $uri $uri/ /logiks/index.php?$query_string;
}

• 重启Nginx生效配置：systemctl restart nginx

步骤4：完成初始化安装 #

• 打开Mac上的浏览器，访问服务器对应地址，格式为http://你的服务器IP/logiks，会自动跳转至安装向导页面
• 按照页面提示依次填入数据库连接信息、后台管理员账号密码
• 确认所有依赖项检测通过后，点击确认即可完成安装

步骤5：安装后安全配置 #

• 登录服务器删除Logiks目录下的install文件夹，避免被恶意触发重新安装
• 将config/config.php文件权限调整为644，防止配置信息泄露

Mac开发端适配配置 #

如果需要用自定义域名本地访问开发站点，可以按以下操作配置：

• 执行Mac终端命令编辑本地hosts文件：sudo vi /etc/hosts
• 在文件末尾添加一行：你的服务器IP logiks.dev，保存退出
• 后续直接在浏览器访问http://logiks.dev即可进入Logiks站点
• 本地开发可以用SFTP、rsync或者git钩子实现Mac本地代码和服务器代码的自动同步

内容的提问来源于stack exchange，提问作者bismay4u