README.md · 虎绿林团队/虎绿林网站程序

hu60wap6
========

hu60wap6 是一个社区系统

由PHP编写

界面简洁，十分简洁，特别简洁，就像非智能手机时代的移动端网页

嗯，这个风格确实的从非智能手机时代继承过来的

hu60wap6 的主要功能有：论坛、聊天室、内信、@Ta、文件图片上传、发言中插入音频视频

其他功能有：编程常用的编码解码器、HTTP请求查看器（可看浏览器UA）

它使用GPLv3协议发布

源代码获取说明
-----------------
本项目包含两个子模块，所以建议采用git来克隆项目及其所有子模块，命令如下：
```
git clone --recursive https://gitee.com/hu60t/hu60wap6.git
```

如果你已经克隆了项目，但不包含子模块，可以通过以下命令获取：
```
git submodule init
git submodule update
```

如果你是下载的源代码压缩包，就需要手动获取子模块并放到对应位置，请参考这个文件中的`url`和`path`：
[.gitmodules](.gitmodules)

安装说明
-----------------

### 注意

网站源代码使用符号连接处理**在不同位置有多个内容相同的文件**这种情况，而符号连接在压缩解压文件时很容易丢失。

如果网站运行在Windows中，建议在WSL内`git clone`或者解压`zip`，以保留符号连接。

如果网站运行在Linux中，请不要在Windows中解压源代码然后重新打包，否则符号连接会丢失。你可以考虑直接在Linux里通过命令行下载源代码并解压，或者使用`git clone`命令获取源代码。

如果你使用Linux桌面，不建议使用Linux版360压缩，它也不支持符号连接。

对于安卓，请不要把源代码放在存储卡或者模拟存储卡（`/sdcard`或者`/storage`），因为这两者都不支持符号链接。如果你没有root权限，只有终端模拟器（比如Termux）提供的内部存储目录支持符号链接。因为源代码无法放置在模拟存储卡，所以虎绿林事实上与安卓上的图形界面web服务器不兼容，只能在终端模拟器内使用命令行web服务器运行。

此外，在`Git for Windows`中启用符号连接支持也无法解决该问题，参见步骤8中的描述。

如果符号连接已经丢失，你会遇到**配置文件"site.info"不存在**错误，请按照步骤8中的说明手动复制文件以解决问题。注意`site_info.conf`复制到目标文件夹后需要改名为`info.conf`。

但是步骤8中要复制的文件并不是完整列表。虎绿林一直在增加对符号连接的使用，完整列表目前已经无法列举，我也不想列举。请使用WSL，对自己好一点。对于安卓，很遗憾，谷歌选择让模拟存储卡不支持符号连接，所以虎绿林只能与安卓上的图形界面web服务器说拜拜。

### 安装教程

* 完整指南：[在安卓Termux终端模拟器中安装虎绿林程序](https://hu60.cn/q.php/bbs.topic.102524.html)
* 只言片语：[在安卓KSWeb中安装虎绿林程序（从38楼到56楼）](https://hu60.cn/q.php/bbs.topic.102524.2.html?floor=38#38)
* 只言片语：[在Linux宝塔面板中安装虎绿林程序（从64楼到67楼）](https://hu60.cn/q.php/bbs.topic.102524.4.html?floor=64#64)

### 通用安装步骤

1. 把 `src` 文件夹里的全部文件放在网站根目录。

3. 如果你使用Linux，可以用如下命令取代下面两步：
   ```bash
   # 先cd到网站根目录
   php script/init.php
   ```
   如果你使用Windows，上面的命令可能不能用，请按照下面两步的说明手动复制文件。

4. 进入网站根目录，把`config.inc.default.php`复制一份，改名为`config.inc.php`。然后再把 `config` 文件夹里的所有 `xxx.default.php` 都复制一份，改名成 xxx.php，去掉 `.default`。如果你准备用git进行版本控制，建议采用复制而不是删除原文件或者直接给原文件重命名。

也就是说，把`config.inc.default.php`复制为`config.inc.php`，再把 `config/xxx.default.php` 复制为 `config/xxx.php`。

5. 进入 `config/tpl` 文件夹，把 `site_info.default.conf` 复制一份，改名为 `site_info.conf`。

也就是说，把 `config/tpl/site_info.default.conf` 复制为 `config/tpl/site_info.conf`。

6. 修改 `config/db.php` ，填写好 mysql 信息。

7. 导入 `db/mysql.sql` 到数据库。

8. 访问。

9. 在Windows中，你可能会遇到这样的错误：
   ```
   Syntax error in config file 'conf:site.info' on line 1 '../../../../config/tpl/site_info.conf'
   ```
   或者这样的错误：
   ```
   Fatal error: Uncaught PageException: 配置文件 "site.info" 不存在
   ```
   这是因为你所使用的Windows版解压缩软件或者git工具不支持符号连接，所以就把链接的源位置做为文本内容保存在了目标位置。
   要解决该问题，你需要把多个文件从源位置复制到目标位置，分别是：
   * `src/config/tpl/site_info.conf` -> `src/tpl/classic/html/site/info.conf` (注意文件要改名为`info.conf`)
   * `src/config/tpl/site_info.conf` -> `src/tpl/jhin/html/site/info.conf` (注意文件要改名为`info.conf`)
   * 还有更多无法列举，包括各种js文件，虎绿林越来越依赖符号链接，所以请在WSL中通过`git clone`获取源代码，对自己好一点。

此外还需要提醒你的是：不要将你的这些更改提交到git版本库，因为我们希望保留符号连接，而不是多个相同文件的复制品。

如果你想要避免这些麻烦，建议在WSL（Windows Subsystem of Linux，适用于Linux的Windows子系统）中运行`git clone`来获得源代码，WSL中的git可以正确创建符号连接。此外，你也可以在WSL中运行web服务器。

新版本的`Git for Windows`如果启用相关选项，也可以创建符号连接，但不适用于本项目。因为在clone本项目时，符号连接的源文件并不存在，所以`Git for Windows`只会创建内容为源文件位置的文本文件做为替代。

10. uid 为 1 的用户会成为系统的管理员用户，可以访问后台（虽然后台只有添加版块这一个功能，修改版块的功能是崩溃的。）

11. 要让附件上传功能生效，不仅需要正确设置七牛云AK/SK，修改html中的域名，还需要正确安装本项目的`nonfree`子模块，参考“源代码获取说明”一节。

12. 要让防CC功能生效，对于Linux，需要允许PHP访问`/dev/shm`文件夹（该文件夹为Linux内的共享内存文件夹）。如果是Apache，使用如下配置：
   ```
   php_admin_value open_basedir "web根目录:其他路径:/dev/shm/"
   ```
   如：
   ```
   php_admin_value open_basedir "/var/www/hu60.cn/src/:/tmp/:/usr/share/phpmyadmin/:/usr/share/php/:/etc/phpmyadmin/:/var/lib/phpmyadmin/:/dev/shm/"
   ```
   对于Windows，请修改`config.inc.php`中的路径（`$CC_DATA`等）为Windows路径，并创建对应的文件夹。

支持的PHP版本
-----------------

* PHP 7
* PHP 8

不支持的PHP版本
-----------------

* PHP 5

为了兼容PHP8.1，放弃了与PHP5的兼容性。

如何开发新主题
--------------

### 新手难度
1. 下载源代码，按照上面的说明进行安装。网站根目录是源代码目录中的`src`文件夹，所以下面说的文件夹路径均省略`src`。
2. 访问网站并切换到`经典主题`。因为`经典主题`比较容易修改。
2. 进入 `tpl/classic/html/index`文件夹（`经典主题`的文件夹），里面的`index.tpl`就是首页的内容。按照你的想法改变其html代码，但是在不了解的情况下，不要动任何位于花括号（`{}`）里面的内容，这里面的内容是smarty模板标记。
3. 进入 `tpl/classic/css` 文件夹，里面的 `default.css` 就是默认css，随你修改。`night.css`是对应的夜间模式css。
4. `tpl/classic/img` 文件夹里面是图片，比如 `hulvlin2.gif` 是默认logo。里面的`face`文件夹放的是表情包。表情包的文件名命名规则详见 [这里](src/img/face/README.md)。
5. `tpl/classic/html/bbs` 里面是论坛各种页面的模板。基本上打开文件你就知道是哪个页面了。随意修改。
6. `tpl/classic/html/user` 是用户中心，`tpl/classic/html/addin` 里面有聊天室的模板，等等。
7. 如果你想要修改网页的头部和尾部，那么在`tpl/classic/html/comm`里面，分别是`head.tpl`和`foot.tpl`。

### 专家难度
1. 下载源代码，按照上面的说明进行安装。网站根目录是源代码目录中的`src`文件夹，所以下面说的文件夹路径均省略`src`。
2. 进入 `tpl` 文件夹，把 `classic` 或者 `jhin` 文件夹复制一份。复制哪个取决于你想拿哪个做为基础主题进行改造。 `classic` 较为简单，但是使用的是较老的模板技术。`jhin` 更复杂，并且使用了模块化（`block`）取代 `classic` 的 `include`。
3. 接下来，打开 `sub/reg_page_bid.php`，在最后一行添加 `page::regTpl('你的主题文件夹名称');`
4. 访问 `http://你的域名/q.php/link.tpl.你的主题文件夹名称.html` 切换到你的主题。
5. 开始修改你的主题吧。`tpl/主题名称`下的目录结构还是比较简单的。`html`文件夹里面是页面的`smarty`模板，放在和`url`中第一部分同名的目录中。比如`http://你的域名/q.php/bbs.topic.xxx.html`对应的PHP文件是`page/bbs/topic.php`，它里面加载了`tpl:topic`这个模板，对应的就是`tpl/主题名称/html/bbs/topic.tpl`。
6. smarty的模板分隔符是默认的`{}`。
7. 引用模板（`{include file="这里"}`）填写的模板名称格式是这样的：`tpl:模板文件名`或`tpl:目录名.模板文件名`，如`tpl:topic`或者`tpl:bbs.topic`，带`目录名.`的主要是访问与当前文件不在同一目录的模板。同样的，主题下的配置文件（`*.conf`）也可以用类似的名称引用：`conf:配置文件名`或者`conf:目录名.配置文件名`。
8. `tpl/主题名/html/comm`里面的是公共模板，可以放被各个页面引用的模板比如header、footer等。
9. 模板中有一些可用的全局变量，比如：
   * `$CID` class id，也就是url的第一部分，比如`http://你的域名/q.php/bbs.topic.xxx.html`中的`bbs`
   * `$PID` page id，也就是url中的第二部分，比如`http://你的域名/q.php/bbs.topic.xxx.html`中的`topic`
   * `$BID` breed id，也就是url中的最后一部分，相当于扩展名，比如`http://你的域名/q.php/bbs.topic.xxx.html`中的`html`
   * `$USER` 当前用户对象，`class/user.php`下`User`类的实例。注意当前用户可能未登录（`$USER->islogin == false`）从而某些属性拿不到。
   * `$PAGE` 当前页面对象，`class/page.php`下`Page`类的实例。`$PAGE`对象可以用来获取当前页面URL中的各种其他细节，也可以用来获取一些静态资源的绝对路径（比如`{$PAGE->getTplUrl("img/hulvlin2.gif")}`，获取`tpl/主题名称/img/hulvlin2.gif`这个文件的绝对URL）。
10. 模板中可以直接调用PHP函数，比如`{date('Y-m-d')}`或者静态类方法`{str::ago(time()-30)}`。
11. 如果要输出由用户编写的内容，记得调用`|code`修饰器来进行`htmlspecialchars()`操作，比如：`{$topic.content|code}`。

虎绿林团队/虎绿林网站程序

简介

发行版

贡献者

近期动态