October CMS是一款基于Laravel框架开发的开源内容管理系统，以MIT协议开源，完全免费商用。October CMS诞生于2014年，以简洁优雅的后台界面、灵活的页面管理、强大的插件生态著称。它采用Twig模板引擎，支持可视化页面编辑、静态页面、博客、商城等功能，适合开发者快速搭建企业官网、博客、作品集、电商网站。
核心优势：基于Laravel框架（PHP开发者友好）、Twig模板引擎、简洁直观的后台、强大的插件市场、可视化页面编辑、支持静态页面和动态组件、完全免费商用、代码结构清晰易于二次开发。October CMS特别适合有Laravel基础的开发者。
环境要求
- Web服务器：Nginx 1.20+ 或 Apache 2.4+
- PHP版本：PHP 8.1 ~ 8.3（October CMS 3.x推荐PHP 8.2）
- 数据库：MySQL 5.7+ / MariaDB 10.3+ / SQLite 3 / PostgreSQL
- 内存：最低512MB，推荐1GB以上
- 磁盘：至少500MB可用空间
- PHP扩展：pdo_mysql、gd、curl、mbstring、json、xml、zip、openssl、fileinfo
- Composer：用于依赖管理（必需）
安装教程
步骤1：安装Composer
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php --install-dir=/usr/local/bin --filename=composer
php -r "unlink('composer-setup.php');"
composer --version步骤2：使用Composer创建October CMS项目
cd /www/wwwroot
composer create-project october/october yourdomain.com
cd yourdomain.com步骤3：创建数据库
mysql -u root -p
CREATE DATABASE october DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'october_user'@'localhost' IDENTIFIED BY 'your_strong_password';
GRANT ALL PRIVILEGES ON october.* TO 'october_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;步骤4：配置数据库连接
编辑 config/database.php 文件，填写数据库连接信息：
'mysql' => [
'driver' => 'mysql',
'host' => 'localhost',
'port' => 3306,
'database' => 'october',
'username' => 'october_user',
'password' => 'your_strong_password',
'charset' => 'utf8mb4',
'collation' => 'utf8mb4_unicode_ci',
'prefix' => '',
],步骤5：运行安装命令
php artisan october:install按照提示设置管理员账号、邮箱、密码，完成安装。
步骤6：Nginx配置
October CMS网站根目录为项目根目录：
server {
listen 80;
server_name yourdomain.com www.yourdomain.com;
root /www/wwwroot/yourdomain.com;
index index.php index.html;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \\.php$ {
fastcgi_pass unix:/tmp/php-cgi-82.sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
location ~* \\.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
expires 30d;
add_header Cache-Control "public, immutable";
}
location ~ /\\.ht {
deny all;
}
}
步骤7：登录后台
访问 http://yourdomain.com/backend 登录后台。October CMS后台功能包括：页面管理、内容块、博客、媒体管理、插件管理、主题管理、设置等。
Windows环境安装（phpStudy集成环境）
Windows用户推荐使用phpStudy集成环境：
- 下载安装phpStudy（https://www.xp.cn），开启Apache/Nginx和MySQL
- 安装Composer for Windows（https://getcomposer.org/download/）
- 在phpStudy的WWW目录下，打开命令行执行：
composer create-project october/october yourdomain.com - 打开phpMyAdmin创建数据库
- 编辑config/database.php配置数据库连接
- 执行
php artisan october:install完成安装 - 浏览器访问http://localhost/yourdomain.com/backend登录后台
宝塔面板安装（推荐）
宝塔面板部署October CMS：
- 安装宝塔面板，登录后一键安装LNMP环境（Nginx + MySQL + PHP 8.2）
- 在软件商店中安装Composer管理工具
- 点击”网站” → “添加站点”，填写域名，创建数据库
- 在网站根目录通过终端执行：
composer create-project october/october . - 编辑config/database.php配置数据库连接信息
- 执行
php artisan october:install完成安装 - 设置目录权限：storage和themes目录设为755，所有者为www
- 浏览器访问域名/backend登录后台
服务器配置建议
- PHP内存限制：
memory_limit = 256M - 上传文件大小：
upload_max_filesize = 32M，post_max_size = 32M - 最大执行时间：
max_execution_time = 120 - 启用OPcache加速
- 配置Redis缓存（Laravel内置支持）
- 定期执行
composer update更新核心和插件 - 定期备份数据库和storage目录
- 生产环境关闭调试模式（config/app.php中debug=false）
常见问题
Q：安装时提示”缺少PHP扩展”？
A：根据提示安装对应扩展：apt install php8.2-gd php8.2-curl php8.2-mbstring php8.2-xml php8.2-zip
Q：后台页面404？
A：确认Nginx配置中包含try_files $uri $uri/ /index.php?$query_string;，确认后台地址为/backend。
Q：Composer安装超时？
A：配置国内镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
Q：忘记管理员密码？
A：执行php artisan october:passwd admin 新密码重置密码。
官方网址
October CMS官网地址：https://octobercms.com