MacOS本地安装FoxCMS

  • 研发部-方方

确认系统环境

确保你的 MacOS 版本支持所需的软件包。可以通过以下命令查看系统信息:

sw_vers

安装 Homebrew

Homebrew 是 MacOS 上常用的包管理工具。如果尚未安装,可以运行以下命令进行安装:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
 
安装完成后,更新 Homebrew:
brew update

安装 PHP

FoxCMS 通常需要 PHP 7.x 

检查是否已安装 PHP:

php -v

如果没有安装,或者版本过低,可以使用 Homebrew 安装:

brew install php

验证安装:

php -v

配置 PHP 扩展

brew install php@7.4 # 如果需要特定版本
brew services start php

编辑 php.ini 文件以启用所需扩展:

sudo nano /usr/local/etc/php/7.4/php.ini

添加或取消注释以下行:

extension=pdo_mysql.so
extension=mbstring.so

安装 MySQL

FoxCMS 需要一个数据库来存储数据。

安装 MySQL:

brew install mysql
brew services start mysql

设置 MySQL 密码:

mysql_secure_installation

登录 MySQL:

mysql -u root -p

创建数据库和用户:

CREATE DATABASE foxcms;
CREATE USER 'foxuser'@'localhost' IDENTIFIED BY 'yourpassword';
GRANT ALL PRIVILEGES ON foxcms.* TO 'foxuser'@'localhost';
FLUSH PRIVILEGES;
EXIT;

安装 Web 服务器

可以选择 Apache 或 Nginx。

使用 Apache:

MacOS 自带 Apache,可以直接启用:

sudo apachectl start

编辑 Apache 配置文件:

sudo nano /etc/apache2/httpd.conf

确保以下模块已启用:

LoadModule rewrite_module libexec/apache2/mod_rewrite.so
LoadModule php7_module libexec/apache2/libphp7.so

重启 Apache:

sudo apachectl restart

使用 Nginx:

brew install nginx
brew services start nginx

编辑 Nginx 配置文件:

sudo nano /usr/local/etc/nginx/nginx.conf

添加类似以下内容:

server {
  listen 80;
  server_name localhost;
  root /path/to/foxcms;
  index index.php;

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

  location ~ \.php$ {
    include fastcgi_params;
    fastcgi_pass 127.0.0.1:9000;
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
  }
}

下载并配置 FoxCMS

从 FoxCMS 官方网站或其他可信来源下载 FoxCMS 的最新版本。

解压并放置到 Web 根目录:

tar -xzvf foxcms.tar.gz
sudo mv foxcms /Library/WebServer/Documents/foxcms # 如果使用 Apache
# 或者
sudo mv foxcms /usr/local/var/www/foxcms # 如果使用 Nginx

配置 FoxCMS:

访问 FoxCMS 的安装页面(例如 http://localhost/),按照页面提示完成安装。

在安装过程中,填写数据库信息:

数据库主机:localhost

数据库名:foxcms

用户名:foxuser

密码:yourpassword

测试运行

完成安装后,访问 http://localhost/,检查 FoxCMS 是否正常运行。

8. 其他注意事项

权限问题:确保 Web 目录和文件具有正确的权限。

sudo chmod -R 755 /path/to/foxcms
sudo chown -R _www:_www /path/to/foxcms # 如果使用 Apache

防火墙:确保 MacOS 防火墙不会阻止 Web 服务器的端口(通常是 80 或 443)。

通过以上步骤,你应该可以在 MacOS 上成功搭建 FoxCMS 的运行环境!