==========================================================
老李壁纸系统 · 安装说明（对应程序 v1.5）
==========================================================

环境要求：PHP 7.4 及以上 + MySQL 5.6 及以上（5.5 实测也能装）。
PHP 扩展：pdo_mysql、gd、mbstring 三个必需（缺 mbstring，保存中文标题和后台设置会直接报错）；
          zip 扩展只有后台「模板管理」上传模板压缩包解压用得到，建议一并打开。
表前缀：默认 laoli_，安装时可以改。

----------------------------------------------------------
一、上传程序
----------------------------------------------------------
1. 解压安装包，把解出来的全部文件放进网站根目录。
   站点根就指向这个程序根目录，**不要**改成 public/，自带的伪静态规则就是按程序根写的。
2. Linux（宝塔 / phpStudy 的 Nginx + PHP-FPM）给三个目录写权限：

       chmod -R 775 storage public/uploads config

   Windows 或 phpStudy 的 Apache 环境跳过这一步。
3. 先在面板里建好一个空数据库和对应的数据库账号（账号要有建表权限；
   懒得建也没关系，安装向导会自动建库，但账号必须有 CREATE 权限）。

----------------------------------------------------------
二、配伪静态（四选一，只用其中一个）
----------------------------------------------------------
不配伪静态，内页和安装页都会 404，只能用 /public/index.php 访问，所以这一步不能省。

· 宝塔面板（Nginx）：网站 → 设置 → 伪静态，把根目录 nginx.htaccess 用记事本打开，
  全选复制、粘贴进去保存。**只粘 server { } 里面的内容**，带外壳宝塔会报错；
  面板区域本来就处在 server 层里，不需要也不能再写 server、listen、root。
· Apache：根目录已经有 .htaccess，什么都不用配，只要站点的 AllowOverride 是 All
  （宝塔、phpStudy 默认都是 All）。
· IIS：根目录已经有 web.config，什么都不用配。
· phpStudy：Apache 用 .htaccess、Nginx 用 nginx.htaccess，按上面两条对应处理。

----------------------------------------------------------
三、打开安装页
----------------------------------------------------------
1. 浏览器直接访问网站域名首页（不用记安装地址）。没装过时这一页自动就是安装向导。
2. 填数据库信息（主机、端口、库名、账号、密码）和管理员账号密码，其余全默认即可。
3. 「写入 15 张演示壁纸」：想装机就有内容看就勾上；要干净的站就不勾，
   之后自己到后台「壁纸管理」上传。
4. 点「开始安装」。程序会自动建库建表、写初始设置、建管理员、建 8 个默认分类、
   插 4 条默认友情链接，一次做完。
5. 装完生成两个文件，别删：
   · config/db.local.php —— 数据库配置，以后换库只改这个文件
   · storage/data/installed.lock —— 安装锁，有它这一页不再显示重置入口

----------------------------------------------------------
四、登录后台与收尾
----------------------------------------------------------
1. 后台地址： 域名/admin/login  用刚才填的账号密码登录。
2. **第一件事：改密码**（后台右上角 → 修改密码），演示密码不要留在线上。
3. 确认站点能正常打开之后，把根目录的 install/ 整个删掉更稳妥
   （不删也有安装锁挡着，删掉是双保险）。
4. LOGO 与浏览器图标：程序自带 public/uploads/site/logo.png 和 public/favicon.ico，
   装完前台页头、后台侧栏、浏览器标签就在用。换成自己的两种办法：
   · 后台「系统设置 → 站点 LOGO 与图标」上传；
   · 直接拿同名文件覆盖这两张。
   这两个文件的位置不要挪：宝塔/phpStudy 的 Nginx 有一条图片正则规则，
   放到 public/logo.png 会被拦成 404，只有 /uploads/ 下面的路径才出图。
5. 本程序免费发行：到后台「授权管理」填免费授权码，点「保存并联网激活」，激活后全部功能开放。
   模板不看授权状态：到官网下载模板压缩包，或直接在后台「模板管理」上传 zip 解压安装。

----------------------------------------------------------
五、常见情况对照
----------------------------------------------------------
1. 首页能开，一进分类或详情页就 404
   → 伪静态没配或没生效。Nginx 改完要点「保存」并重载，Apache 改完重启一次。
2. 打开首页是一片空白或者 500
   → storage/ 或 config/ 不可写。Linux 执行第一步那条 chmod；
     宝塔「网站 → 权限」把工作目录所有者改成 www。
3. 打开首页显示的还是安装向导
   → 说明没装成功。看 storage/config 写权限；库账号有没有 CREATE 权限。
4. 保存分类、标签等中文内容时报错或标题变成省略号
   → PHP 缺 mbstring 扩展，面板的「PHP 设置 → 安装扩展」里装上。
5. 后台「模板管理」上传模板包装不开
   → 包的目录层级不对。theme.json 要在主题目录第一层，
     打包要在主题目录的上一层用相对路径打：tar -a -cf tpl-mine.zip tpl-mine/
     Windows 右键「发送到 → 压缩文件夹」打出来的包条目名带反斜杠，Linux 解不开。
6. 忘记管理员密码（后台不提供明文找回，需要进数据库执行一条 SQL）
   phpMyAdmin 或宝塔「数据库 → 管理」里执行：

       UPDATE laoli_admins
          SET password = '$2y$10$4mxDRMxCPx5TatY1ybizEOd2E9hb4r1J7BYJn86qpl2ukrAMpq9ya'
        WHERE account = '你的管理员账号';

   执行后用密码 Bizhi@2026 登录，登录后立刻改成自己的。
   表前缀默认 laoli_，安装时改过就换成对应前缀。
7. 换服务器 / 换数据库
   → 数据整库导出导入，程序目录原样搬，只改 config/db.local.php 里的库名账号密码。
      图片在 public/uploads/，模板在 templates/，缓存日志在 storage/，都不影响数据。

----------------------------------------------------------
升级（低版本覆盖到本版本）
----------------------------------------------------------
下载新版整包解压，覆盖 app/、templates/、public/、install/ 四个目录即可。
你的数据在数据库里、配置在 config/db.local.php、图片在 public/uploads/、
自己上传的模板在 templates/，覆盖不会动到这些。
覆盖后到后台「清空缓存」点一下（或删掉 storage/cache 里的文件），刷新页面就是新版。

----------------------------------------------------------
联系
----------------------------------------------------------
联系 QQ：1735737677　交流群：1023163759
部署、二开、装模板遇到问题把报错页面截图发过来即可。
