上传变量

另请参见:上传,上传管理员.

$EnableUpload(启用上载)
如果$EnableUpload(启用上载)变量在config.php中为true。请注意,用户可能仍需要设置上传密码才能上传(请参阅上传管理员).
$EnableUploadDrop
如果此变量设置为1,则启用编辑表单和上传表单上方的“拖放区域”,允许从文件管理器拖放文件以进行上传,请参阅上传#drop(新增于2.3.36)
$EnableUploadDrop=1;
$上传分机
一个数组,其中包含可以附加到wiki的文件扩展名作为键,以及这些扩展名的标准MIME内容类型作为值。请参阅将新文件类型添加到允许的上载.
$EnableUploadMimeMatch
默认情况下,PmWiki只检查文件扩展名,用户可能会上载扩展名错误的文件(例如,扩展名为DOC的PDF文件,或扩展名不允许的文件重命名为允许的文件)。将此变量设置为真的将检查MIME内容类型上传的文件,如果它与中定义的不匹配$上传分机,上传将被拒绝。
$EnableUploadMimeMatch=true;
请注意,有时这可能会阻止有效文件,例如,CSV文件可能被检测为“text/plain”或“application/CSV”,或者受密码保护的办公文件可能显示为“application/encrypted”。要允许此类文件,请将扩展的允许内容类型配置为正则表达式:
$EnableUploadMimeMatch=数组('csv'=>'^(text/plain|application/csv)$!','docx'=>'^(应用程序/加密)$!',“gpx”=>“^(文本/xml)$!',#修复上传gpx文件的mime类型);
还要注意,这需要PHP Fileinfo函数要启用-在大多数系统上都是这样,但在Windows上可能需要php.ini配置和服务器重新启动。
$上传黑名单
[已弃用:使用$上传块模式]此数组包含上载文件名的禁止字符串(不区分大小写)。一些使用Apache服务器的安装会尝试执行一个名称包含“.php”、“.pl”或“.cgi”的文件,即使它不是文件名的最后一部分。例如,可能会执行名为“test.php.txt”的文件。要禁止上传此类文件,请在config.php中添加以下行:
$UploadBlacklist=数组('.php','.pl','.cgi','.py');#不允许通用脚本文件
$上传块模式
此字符串或数组包含要为上载的文件名阻止的模式(不区分大小写)。一些使用Apache服务器的安装会尝试执行一个名称包含“.php”、“.pl”或“.cgi”的文件,即使它不是文件名的最后一部分。例如,可能会执行名为“test.php.txt”的文件。要禁止上传此类文件,请在config.php中添加一行逗号分隔的通配符模式:
$UploadBlockPatterns='*.php*,*.pl*,*.cgi*,*.py*';#不允许通用脚本文件
$上传永久添加
此变量设置应用于新上载文件的附加unix权限,应为0(建议自2013年起使用)。如果上传的文件无法下载并显示在网站上,例如出现错误403 Forbidden,请将此值设置为0444(核心设置,自2004年以来默认设置)。
$UploadPermAdd=0;#推荐
$UploadPermSet
此变量无条件地设置应用于新上载文件的unix权限,例如0604. 危险!除非您知道自己在做什么,否则不要使用此变量!如果您出错,可能无法通过FTP/SSH帐户编辑或删除上传的文件(在这种情况下,食谱:可附可以使用)或下载并在网站上显示。请注意,不同系统上的文件权限可能不同-如果复制或移动PmWiki安装,则可能需要更改它。
$上传目录
存储上传的目录。默认为上传/在pmwiki目录中,但可以设置为服务器上的任何位置。如果要进行上传,此目录必须可由Web服务器进程写入。
$上传UrlFmt
给定目录的url$上传目录。默认情况下,$上传UrlFmt派生自$PubDirUrl(发布目录URL)$上传目录.

$IMapLinkFmt(美元)['附件:']
存在附件时显示的上传链接的格式。可以使用这样的行进行更改配置.php:
$IMapLinkFmt[Attach:']=“<a class='attachlink'href='\$LinkUrl'>\$LinkText</a>”;
$LinkUploadCreateFmt
附件不存在时显示的上传链接的格式。可以在中使用这样的行进行更改配置.php:
$LinkUploadCreateFmt=“<a class='createlinktext'href='\$LinkUpdate'>\$LinkText</a><a class='createlink'href='\$LinkUpload'>&三角洲</a> ”;
$上传前缀Fmt
设置上传文件的前缀,以允许按组以外的其他方式组织附件。默认为“/$组”(上传是按组组织的),但可以为站点范围或每页附件设置其他值。
$上传前缀Fmt=“/$Group/$Name”;#每页附件
$上传前缀Fmt= ''; # 站点范围的附件
建议使用$上传前缀Fmt变量定义于配置.php对于wiki中的所有页面都相同,而在组/页面本地配置文件中则不同。否则你无法链接到其他wiki组中的附件。
$EnableDirectDownload(启用直接下载)
当设置为1(默认值)时,指向附件的链接将绕过PmWiki,直接来自Web服务器。设置$EnableDirectDownload(启用直接下载)=0; 导致通过获取附件请求?action=下载这允许PmWiki使用页面的读取权限保护附件,但也会增加服务器上的负载。不要忘记使用.ht访问文件(全部拒绝订单、允许/拒绝)。
$EnableDownloadRanges(启用下载范围)
当wiki已保护下载时(请参阅$EnableDirectDownload(启用直接下载)),它发送一个HTTP头“Accept-Ranges”,如果浏览器请求,它可以提供部分内容。这对于视频等大文件很有用,默认情况下启用。将此变量设置为0可禁用此功能并仅为整个文件提供服务。
$EnableUploadGroupAuth(启用上载组身份验证)
设置$EnableUploadGroup授权= 1;使用组密码验证下载。这可以与一起使用$EnableDirectDownload(启用直接下载)= 0;.注:$EnableUploadGroup授权如果您的wiki使用每页附件,则不应启用。
$EnableUploadVersions(启用上载版本)
设置为1(默认值为0)时,将文件上载到已存在同名文件的位置会导致旧版本重命名为文件.ext,时间戳(而不是被覆盖)。时间戳是Unix样式的时间戳。
当设置为2时,如果已经存在同名文件,它将重命名新的文件添加唯一后缀,例如现有文件-s99hup公司.jpg格式。后缀是当前Unix时间戳的base-36表示。
$EnableUploadOverwrite(启用上传覆盖)
设置为1(默认值)时,确定是否允许覆盖以前上载的文件。
$上传名称字符
上传名称中允许的字符集。默认为“-\w.”,这意味着可以在上传名称中使用字母数字、连字符、下划线、点和空格,其他所有内容都将被剥离。只能启用wiki的代码页(字符集)中存在的字符,请参阅维基百科:代码页.
$上传名称字符=“-\\w.”;#默认值:允许短划线、字母、数字、下划线和点(无空格)
$上传名称字符=“-\\w.\\x80-\\xff”;#允许使用Unicode
注意:由于协议或操作系统、文件系统和服务器软件的各种限制,或者与PmWiki标记冲突,并非所有字符都可以用于文件名:
  • +?:@#%!=/在URL地址中有特殊含义,
  • |\^`[]?:@#%/在某些系统上可能无法保存,
  • <>"|\^`(){}[]#%可能与PmWiki标记冲突,
因此,强烈建议只有在知道自己在做什么的情况下才启用这些功能。
$MakeUploadNamePatterns($Make上传名称模式)
用于规范化附加文件的文件名的正则表达式替换数组。首先,除了$上传名称字符将被剥离,然后文件扩展名将转换为小写。管理员可以使用自定义定义覆盖这些替换(需要定义完整阵列)。当前默认顺序为:
$MakeUploadNamePatterns=数组(“/[^$UploadNameChars]/”=>'',#删除所有不允许的字符'/\\.[^.]*$/'=>'cb_tolower',#将扩展名转换为小写(回调函数)'/^[^[:alnum:]_]+/'=>'',#删除初始空格、破折号、点'/[^[:alnum:]_]+$/'=>''))#去除尾部空格、破折号、点
$UploadDirQuota(上传目录配额)
所有上传的总大小限制。
$UploadDirQuota=100*1024;#将上传限制为100KiB$UploadDirQuota=1000*1024;#将上传限制为1000KiB$UploadDirQuota=1024*1024;#将上传限制为1MiB$UploadDirQuota=25*1024*1024;#将上传限制为2500万B$UploadDirQuota=2*1024*1024x1024;#将上传限制为2GiB
$UploadPrefixQuota
包含上载的一个目录的总大小限制。此目录通常是上传/组名(每个WikiGroup一个),或上传/组/页面名称(每页一个),取决于变量$上传前缀Fmt.
$上传最大大小
上传文件的最大大小,默认为50000字节。
$UploadExtSize(上传扩展大小)
每个扩展的最大大小,覆盖中的默认值$UploadMaxSize(上传最大大小).
$UploadExtSize['zip']=2*1024*1024;#zip文件最多允许2MiB
$ImgDark后缀
上传图像的后缀,适用于深色主题。启用条件:
$ImgDarkSuffix=“-暗”;
如果你的皮肤支持在浅色和深色主题之间切换,那么背景为白色或非常浅色的图片在深色主题上可能会显得过于明亮。你可以上传一张单独的图片来适应黑色主题,使用相同的文件名,并添加后缀,比如“-黑暗“。您的照片可能是”公司logo.png“和”公司徽标-黑暗.png码,要嵌入它们,请使用标记附件:company-logo.png“。当黑色主题处于活动状态时,PmWiki将使用黑色图片。另请参阅$EnableDarkThemeToggle(启用深色主题切换)食谱:深色方案.仅切换附加到页面的嵌入图片。A类链接对于这样的图片,即使启用了暗主题,也会打开基础(光)文件。
$UploadRedirectFunction(上传重定向功能)
发布文件后要调用的函数。默认情况下,使用参数调用“Redirect”函数$页面名和的URL?action=上传页面(如果上传成功或为什么没有成功,以及文件是否被重命名,请提供其他信息)。插件可以定义自己的功能,例如AJAX上传可能只会将一些变量返回到浏览器。


此页面可能包含上的更新版本pmwiki.org网站:PmWiki:上传变量、和对话页面:PmWiki:上传变量-对话.