《火牛微享聚合裂变营销系统》部署环境说明

本文档供需要对服务器进行运维、二次简单修改的朋友阅读，用于对服务器和网站的部署情况进行初步了解。

所有操作都需要通过 Linux 命令进行，阅读文本档前必须了解熟悉 Linux 相关操作。

切记，在进行任何操作前都请务必做好备份工作，数据无价。

Nginx 服务

• 服务器使用 Tengine 3.0 (或更高版本)作为 Web 服务器，其安装在 /opt/tengine 目录下面。
• 系统服务名称为 nginx，可以使用命令 systemctl restart nginx 来重启服务，或 reload 来重载配置文件。
• Nginx 运行的用户组为 www:www
• nginx.conf 等配置文件在 conf 目录下面，hosts 目录下面为各主机的配置文件。
• 日志在 log 目录下面，使用 logrotate 对历史日志进行压缩存放，最大保留30天，详见 logrotate 的配置文件 /etc/logrotate.d/nginx
• Tengine 编译的时候携带了 openssl 3.x 和 brotli 压缩组件，更多编译参数细节可以使用 nginx -V 查看。

PHP 服务

• 服务器使用 PHP 7.3 版本，其安装在 /opt/php73 目录下面。
• 系统服务名称为 php73，可以使用命令 systemctl restart php73 来重启服务。
• PHP 运行的用户组为 www:www
• PHP 以 php-fpm 模式运行的，php.ini 文件和 php-fpm.conf 文件都在安装目录下的默认配置目录下面。
• PHP 额外加载了 imagick 和 apcu 两个扩展。另外，在编译 PHP 的时候，建议先升级系统内的 curl 到 8.0 或更高版本。
• PHP 的编译参数等信息可以使用 phpinfo 函数或 php -i 来查看，里面所有环境相关信息都能找到。

MySQL 数据库

• 服务器使用 Percona 8.0.23 (或8.0系列的更高版本)作为数据库服务器，其安装在 /opt/percona 目录下面。
• 系统服务名称为 mysql，可以使用命令 systemctl restart mysql 来重启服务。
• 数据库的数据存放在 /data/mysql 目录下面，配置文件在 /opt/percona/etc/my.cnf 路径。
• 数据库运行的用户组为 mysql:mysql
• 数据库的默认用户名、密码都是root，且数据库只允许使用 127.0.0.1 这个IP地址链接。
• 因为数据库默认不允许外网链接，如果需要在外网连接数据库服务器的话，你可以使用诸如SSH隧道之类的方式，去连接数据库服务器。
• 为确保安全，请不要放行其他链接地址，也千万不要设置允许任意IP地址连接。如果为了图方便或其他原因一定要放行任意IP连接的话，请务必修改数据库密码，且必须要修改一个强一点的密码，并自行做好其他防护措施。修改密码后网站配置文件中的数据库连接参数别忘了一并修改。
• 请不要安装 PhpMyAdmin 之类的软件去连接或管理数据库服务器，错误的配置PMA会使得数据库的安全鉴权弱化，如一定要使用的话，请务必修改数据库密码，自行做好防护措施。
• 如果需要备份数据库内容，请使用mysqldump命令进行备份，备份的时候请务必使用指定 UTF8MB4 作为连接编码，不然备份数据会错乱的。 数据库备份命令参考(仅供参考，自行修改连接信息)：/opt/percona/bin/mysqldump --default-character-set=UTF8MB4 --set-charset -uroot -proot -h127.0.0.1 huoniu_fusion > dump.sql

FTP 服务

• 服务器使用 proftpd 1.3.8 (或更高版本)作为 FTP 服务器，其安装在 /opt/proftpd 目录下面。
• 系统服务名称为 proftpd，可以使用命令 systemctl restart proftpd 来重启服务。
• 相关配置文件都在安装目录下的 etc 目录里面。
• FTP 服务仅用于管理网站文件，如果你使用了 SFTP 或其他方式管理服务器文件，不需要使用 FTP 的话可以直接卸载或禁用掉。

其他服务器相关

• 生产环境目前使用 CentOS 7.x 系统，其他 Linux 发新版本未进行测试，Windows 环境肯定不能运行的（Windows用户可通过搭建虚拟机来运行 CentOS 系统）。
• 上述这些软件在这台服务器上进行编译的，直接拷贝到其他机器上无法直接运行。如果你要在其他服务器上搭建这套运行环境的话，请查看完整编译参数后去新服务器上编译安装即可。编译的时候建议使用 GCC 11 或更新版本，不要用系统自带的 4.8 这种老旧版本。
• Percona 数据库编译可能有点复杂，确实有困难的话，可以直接使用 percona 官方编译好的发行版。或者直接使用原版 MySQL 或 MariaDB 或各类云数据库也可以。其他号称兼容MySQL的信创数据库请自行测试。
• 生产环境没有设置以上几个软件的 PATH 环境变量，所以你要执行命令的话，请使用完整目录或自行添加环境变量。比如 /opt/php73/bin/php -i 来查看PHP相关信息，又比如 /opt/percona/bin/mysql -u root -p -h 127.0.0.1 来登陆MySQL数据库。

网站程序相关

• 网站安装在 /data/webapps/huoniu_fusion 目录，数据库名称为 huoniu_fusion，Nginx配置文件在 /opt/tengine/conf/hosts/huoniu_fusion.conf
• 由于 PHP 运行的的用户为 www，所以你如果使用 root 用户修改了网站，切记修改文件所有者为 www:www，以免运行时出现权限不够导致报错。
• 如需完整网站源程序的话，请自行从服务器上复制。可以现在服务器上打个压缩包，然后用SSH搬下来就好了。网站的数据库文件也可以直接从服务器上导出即可。
• 网站的部分业务逻辑使用了 Swoole Compiler 进行加密，这些文件请不要修改。页面控制器、页面模板、配置文件都是没有加密的。运行加密文件需要 Swoole Loader 扩展，该扩展文件在 /opt/php73/lib/php/extensions/no-debug-non-zts-20180731/swoole_loader.so 目录。
• 系统后台只允许授权登录域名访问，并且会校验服务器的IP地址，前台访问不进行授权检测。你要在本地搭建进行开发和测试的话，务必使用授权域名来访问系统（可以修改hosts文件将域名解析到本地即可，或者 SwitchHosts 这类软件辅助切换hosts环境配置），其次再将本地的IP地址发给售后人员，由售后来添加到授权白名单中，如果IP地址变动频繁的话，建议联系宽带运营商配置固定IP地址（只可额外增加一个IP地址授权，且IP授权每月只能修改一次）。
• 网站系统基于 Symfony 5.3 (或5.x系列的更高版本)框架开发，框架官方文档详见 https://symfony.com/doc/5.x/index.html，该框架专业性比较强，入门有一定的难度。建议先对框架充分熟悉之后再进行二次开发，你会省下很多很多很多时间。其实精通框架后再来看网站结构，你会发现整个项目并不复杂。
• 网站的配置文件在 app/config/parameters.yml。配置文件都是用YAML语法编辑。一些字段说明如下，其他几个下面未提及的字段请保持原样，千万不要修改。
  

  secret: 网站密钥，32位随机字符串
  database_host: 数据库服务器地址
  database_port: 数据库服务器端口（默认3306）
  database_name: 数据库名称
  database_user: 数据库服务器登陆用户名
  database_password: 数据库服务器登录密码
  nginx_config: Nginx配置文件绝对路径，用于后台的Nginx管理功能，可以留空。

• Symfony 框架及其关联组件有编译缓存，缓存文件在 app/cache 目录，如果你修改了业务没有生效的话，可尝试删除缓存。删除缓存一般不会影响系统功能，且后续会自动重建的。如果删除缓存后网站报错了，那就是你修改的代码有问题，跟缓存无关。
• 另有一些业务级的缓存文件在 app/temp 目录下面，比如邀请好友海报的生成缓存。这个目录也可以清空，后续会自动重建。
• 系统的一些定时任务和复杂业务处理使用计划任务进行执行，可在服务器上使用 crontab -u www -l 命令来查看 www 用户的计划任务。
• 测试环境下可以直接使用 Debug 方式运行，修改 web/portal.php 文件，让 $isDebug 值为 true 就行，可以很方便得修改代码后立即查看效果。但是，切记生产环境千万千万千万不要不要不要直接开启 Debug 模式。