版本:v1.0
本文介绍如何设置config.php文件。
本文件使用Markdown语法,若您使用记事本等文本编辑器查看,请注意区分格式标记,这些标记并不是内容的组成部分。
如:
表示说明 (两个各有一个星号)
表示强调(两侧各有两个星号)
表示代码
(两侧各有一个反引号,中间的内容才是代码内容,输入代码时请不要包括反引号)
<表示链接>(两侧各有一个尖括号)
如果您使用Windows,可以使用MarkdownEditor来查看本文档。下载地址:https://github.com/jijinggang/MarkdownEditor/blob/master/download/MarkdownEditor.zip?raw=true
所有设置都使用常量声明来完成,常量声明的格式是:
define('常量名', 常量值);
在config.php中,常量名即设置项的名称,由大写字母和下划线组成。
常量值可以是字符串、布尔值、整型、浮点型等标量类型。修改设置时,请仅修改常量值的部分。
- 字符串由英文单引号(')或双引号(")包围,本文件中使用单引号;
- 布尔值只有
true
或false
,不区分大小写,本文件中使用小写(注意有的设置项虽然是true或false,但其值为字符串而不是布尔值,需要用引号包围); - 整型数值直接用十进制表示;浮点型用小数点分隔的两段十进制数字来表示。
下面对每一个设置项进行说明,包括设置项的作用和取值。
字符串值
默认值:'en'
设置界面的默认语言,用户可以在界面右上角的语言切换自行切换成其他语言。
取值为合法的ISO 639-1语言缩写,目前仅支持'en'
(英语)、'zh-CN'
(中文(中国))和'ja'
(日本语)。关于翻译事宜,请联系[email protected]
字符串值
默认值:'default'
设置主界面所使用的主题,该主题必须在themes目录下。
字符串值
设置网站的标题,显示在浏览器的标题栏中。
字符串值
设置网站的说明,包含在网站头部的<meta>
元素中。
字符串值
设置网站的关键字,包含在网站头部的<meta>
元素中。
字符串值
管理员的Email地址,会包含在页面的反馈信息中。
字符串值
默认值:'4M'
表示限制上传文件大小的字节数,可以使用T、G、M、K作为后缀,不去分大小写。
注意php.ini中的post_max_size和upload_max_filesize会影响到实际可上传的文件大小。
字符串值
默认值:'uploads'
默认上传文件的目录,注意目录权限要可以读写。
字符串值
默认值:'thumbs'
默认缩略图的目录,注意目录权限要可以读写。
字符串值
默认值: 'admin'
管理界面的登录名。请一定要修改。
字符串值
默认值:'admin'
管理界面的登陆密码。请一定要修改。
布尔值
默认值:false
是否开启CDN。如果您的使用CDN并且有多个域名均是主站的缓存或镜像,可以开启此选项。
此选项只影响域名,无法影响到目录。即,您的图片保存在主站位置是http://www.example.com/uploads/abs.jpg*,则启用CDN并添加*cdn1.example.com*,则会返回*http://cdn1.example.com/uploads/abs.jpg*作为图片地址,*uploads/abs.jpg*的部分会保持不变。
启用CDN后域名会在如下设置的CDN_LIST中随机取用,如果仍想再返回的地址中包括主站地址,请将主站地址添加进CDN_LIST*。
字符串值
设置CDN开启后随机取用域名的列表,多个域名以英文逗号(,)分隔,可以使用数字IP地址。
字符串值
默认值:'both'
取值范围:'forceon'
、'forceoff'
、'on'
、'off'
、'both'
设置CDN是否开启HTTPS。
可以只设置一个值,代表全部开启或不开启。
也可以设置由英文逗号(,)分隔的多个值,分别对应CDN_LIST的各个域名。如果多个值的数量少于CDN_LIST的域名数量,设置无效。如果某个域名想保持默认(both)可以留空,如'both,,on'
分别设置第一个域名均可、第三个域名开启,第二个域名默认不开启。
各取值的取用情况如下:
- forceon:不论如何都HTTPS取用。
- forceoff:不论如何都以HTTP取用。
- on:只会在HTTPS访问上传页面的情况下以HTTPS取用。
- off:只会在HTTP访问上传页面的情况下以HTTP取用。
- both:在HTTP访问上传页面的情况下以HTTP取用,在HTTPS的情况下以HTTPS取用。
若上传页面以HTTP访问,会以HTTPS取用设置为forceon的域名,以HTTP取用off或both或forceoff的域名,不会取用on的域名。
若上传页面以HTTPS访问,会以HTTPS取用设置为on或both或forceon的域名,以HTTP取用forceoff的域名,不会取用off的域名。
建议不要依赖forceon或forceoff选项,而是用on、off、both来根据上传页面自适应协议。只有在全部强制启用或全部强制不启用的情况再使用forceon或forceoff。
不要全部设置为on或off,这样在HTTP的情况下将无法取用到全部为off的域名,在HTPPS的情况下将无法取用到全部为on的域名,造成无法取到任何域名的问题。除非上传页面只能通过HTTP访问才能设置为全部off,或上传页面只能通过HTTPS访问才能全部设置为on。
字符串值
默认值:''
取值范围:0~65535之间的整数(注意此设置为字符串值)
设置CDN域名的端口。留空表示使用默认值(HTTP为80)。 这个设置只对CDN_HTTPS设置为forceoff、off或both的域名有效。
可以设置一个值,表示全部使用某个端口。
也可以设置由英文逗号(,)分隔的多个值,分别对应CDN_LIST的各个域名。如果多个值的数量少于CDN_LIST的域名数量,设置无效。如果某个域名想保持默认(HTTP为80)可以留空,如'667,,8080'
分别设置第一个域名端口为667、第三个域名端口为8080,第二个域名默认。
字符串值
默认值:''
取值范围:0~65535之间的整数(注意此设置为字符串值)
设置CDN域名的HTTPS端口,留空表示默认(HTTPS为443)。 这个设置只对CDN_HTTPS设置为forceon、on或both的域名有效。
可以设置一个值,表示全部使用某个端口。
也可以设置由英文逗号(,)分隔的多个值,分别对应CDN_LIST的各个域名。如果多个值的数量少于CDN_LIST的域名数量,设置无效。如果某个域名想保持默认(HTTPS为443)可以留空,如'667,,8080'
分别设置第一个域名端口为667、第三个域名端口为8080,第二个域名默认。
字符串值
这是在页面底部的版权声明,可以使用HTML代码。
布尔值
默认值:false
是否启用水印。
水印是永久加在图片上的,不可恢复。
因为水印会导致GIF动画失效,因此只能对JPEG和PNG格式的图片打水印。
水印图片是site-img/watermark.png(严格区分大小写),可以使用半透明PNG图像。
字符串值
默认值:'200x200'
要加水印的图片的最小尺寸,小于这个尺寸的图片将不加水印。
值由宽x高表示,均为正整数,只要图片的宽度小于设置的宽度,或者图片的高度小于设置的高度就不会加水印,而用两者都小于。
字符串值
默认值:'10,10'
要加水印的位置。
值由x,y表示,均为整数,坐标是从图片的左上角开始计算的,x轴右延伸,y轴向下延伸。如果坐标为负数,则表示坐标为图片的宽减去x或高减去y的值。
水印图片会以原始大小贴在坐标所表示的位置上,水印图片的左上角对准原图片坐标*(x,y)的位置。
如:假设图片大小为200x300,则10,10表示水印贴在图片坐标(10,10)的位置,-10,10表示(190,10),10,10表示(10,290),-10,-10*表示(190,290)。