适用人群：
如果你是个刚摸到键盘就想把网站立起来的新兵蛋子，或者是个受够了WordPress臃肿加载、插件打架、动不动就“哎呀内存不够”的老油条，这篇教程就是为你准备的。
条件是：你会用电脑、会打开命令行（别怕，那玩意儿就是个黑框框），能区分“复制”和“粘贴”就行，不需要PHP大牛，不需要服务器老司机，跟着我一步一步走，保证两小时内给你一个能跑起来、能填内容的PyroCMS站点。
第一步：检查你的武器（服务器环境）
PyroCMS 3.x 是基于 Laravel 框架的，对环境的硬要求就三条：
- PHP >= 7.2（推荐 7.4 或 8.0，别用 8.1 以上，有些第三方模块还没适配）
- MySQL 5.7+ 或 MariaDB 10.2+
- Composer（PHP依赖管理工具，这玩意儿必须装）
踩坑预警 #1：
别以为装了PHP就完事了！必须装这些扩展：pdo_mysql、mbstring、xml、curl、gd、zip、openssl，很多新手卡在“白屏”就是因为少了一个mbstring，用命令行检查：
php -m | grep -E 'pdo_mysql|mbstring|xml|curl|gd|zip|openssl'
如果哪个没显示,去你的服务器面板（宝塔、PhpStudy之类的）把扩展勾上，或者回你主机商那重装PHP组件，别问我怎么装，百度“PHP 安装 mbstring”五分钟搞定。
PyroCMS实战，像组装步枪一样快速搭建你的网站—老鱼雷的硬核教程
武器库准备：
- 一个空的MySQL数据库（名字、用户名、密码记下来）
- 一个独立域名或IP（本地测试用localhost也行，但千万别在生产环境用Apache默认的
/var/www/html这种变态权限目录）
第二步：装弹——下载PyroCMS核心
别去官网下那个zip包手动解压,太业余了，用Composer一把梭：
composer create-project pyrocms/pyrocms mywebsite
这条命令会在当前目录生成一个mywebsite文件夹，里面就是完整的PyroCMS项目。
如果报错“内存不足”或“超时”，多半是镜像问题，立马换成国内镜像：
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/
然后再执行上面的创建命令,还没好？检查你是不是用了sudo，如果是在Linux下，别用root直接跑composer，那会导致文件权限全变成root，后面各种麻烦。
踩坑预警 #2：
Composer 版本必须是 2.x 以上，老版本1.x 会下载失败，用 composer --version 看，如果是1.x，去官方更新脚本跑：
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php --install-dir=/usr/local/bin --filename=composer
第三步：瞄准——配置环境文件
进入项目目录：
cd mywebsite
复制环境文件：
cp .env.example .env
用文本编辑器打开这个.env文件（别用记事本！用VS Code、Notepad++或者vi都行），修改这几行：
DB_HOST=127.0.0.1 DB_DATABASE=你的数据库名 DB_USERNAME=你的数据库用户 DB_PASSWORD=你的数据库密码
配置要点：
APP_URL改成你的域名，http://localhost或者https://yourdomain.com，结尾不要加斜杠！APP_ENV=local表示本地开发；上线后改成production，同时把APP_DEBUG=true改成false，否则别人能看到你的数据库密码。- 邮件配置（
MAIL_*）可以先不管，需要发邮件的时候再改。
保存后,生成应用密钥（这步必须做，否则安全风险）：
php artisan key:generate
你会看到输出 Application key set successfully. 这时候.env里的APP_KEY会自动填入一串乱码。
第四步：开火——安装数据库并创建管理员
现在把子弹装进弹夹：
php artisan install
这个命令会执行数据库迁移、填充默认数据、创建管理员账号，过程中会在命令行里问你几件事：
- Site Name：网站名称，老鱼雷兵器店”
- Admin Email：管理员邮箱，之后登录用
- Admin Username：管理员用户名（我建议就用email的前缀）
- Admin Password：密码，至少8位，带大小写字母和数字。
全部填完,两三秒后，你会看到类似：
Installation complete! You can now log in to the control panel at /admin这时候你的数据库里已经建好了表,框架也初始化了，但先别激动，还有一步关键操作：目录权限。
第五步：检查准星——权限和Web服务器配置
文件权限（Linux服务器必须做，Windows用户忽略）
在项目根目录下执行：
sudo chmod -R 775 storage bootstrap/cache sudo chown -R www-data:www-data storage bootstrap/cache
把www-data换成你Web服务器的用户（比如nginx用户是nginx，apache用户是daemon或www-data），不设置的话，后面上传图片、生成缓存全报错。
Nginx配置（如果你用Apache，看下面）
在Nginx的站点配置文件里,将root指向mywebsite/public（注意是public目录，不是根目录），然后加入这段 rewrite 规则（核心！）：
location / {
try_files $uri $uri/ /index.php?$args;
}
location ~ \.php$ {
fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
踩坑预警 #3：
如果你用Apache，必须启用mod_rewrite，并且在public目录下已经有一个.htaccess文件，如果访问任何页面都返回404，八成是.htaccess没生效或AllowOverride没开，在Apache的VirtualHost配置里加上：
<Directory /path/to/mywebsite/public>
AllowOverride All
</Directory>然后重启Apache。
踩坑预警 #4：
访问http://你的域名/admin 看到的是空白页？先检查PHP错误日志（一般在/var/log/php_errors.log或storage/logs/laravel.log），最常见的原因是storage/logs目录不可写，或者PHP的memory_limit太低（建议至少256M），修改php.ini里的memory_limit = 256M，重启php-fpm。
第六步：试射——登录后台，添加第一个页面
浏览器输入 http://你的域名/admin，用刚才设置的管理员邮箱和密码登录。
你会看到一个清爽的后台，左边菜单有“Pages”、“Streams”、“Users”等，点击“Pages” → “Add Page”，选一个布局（默认有“Default”），输入标题和内容，保存。
再访问首页，你刚刚创建的页面已经出现了。
就这么简单？对，PyroCMS的核心理念就是“内容类型即模型”，比起WordPress的post/page死板分类，这玩意儿可以让你自己定义字段（商品”需要图片、价格、库存），然后自动生成表单和管理界面，这些高级玩法以后慢慢学，今天先把骨架立起来。
最后的战场建议
- 备份比兄弟重要：每周导出一次数据库（
mysqldump），把storage/app里的上传文件打包。 - 更新不要手贱：PyroCMS核心更新用
composer update，但务必先做数据库备份，因为有些版本迁移会改字段，搞不好就把数据清空。 - 别碰系统自带模块：PyroCMS自带的
Pages、Navigation、Users模块不要删，它们是骨架，你只扩展自己的Stream。
好了,你现在已经有了一个能跑起来的PyroCMS网站，真正的战士不是靠装备打仗，而是靠脑子，这个框架给了你一把好枪，接下来开火还是卡壳，全看你怎么配置，遇到问题别慌，先看storage/logs/laravel.log，90%的答案都在那。
如果还搞不定？回车间擦枪，重新走一遍步骤二，别问我为什么，问就是在帮你养成良好习惯。
—— 老鱼雷，退役。
发表评论