响应式商品展示的网站源码,网站服务器的功能,网站界面怎么做,上海建设官方网站前言 本规范由编程原则组成#xff0c;融合并提炼了开发人员长时间积累下来的成熟经验#xff0c;意在帮助形成良好一致的编程风格。适用范围 如无特殊说明#xff0c;以下规则要求完全适用于Discuz!项目#xff0c;同时也可大部分适用于COMSENZ旗下其他PHP项目。标准化的重… 前言 本规范由编程原则组成融合并提炼了开发人员长时间积累下来的成熟经验意在帮助形成良好一致的编程风格。适用范围 如无特殊说明以下规则要求完全适用于Discuz!项目同时也可大部分适用于COMSENZ旗下其他PHP项目。标准化的重要性和好处 当一个软件项目尝试着遵守公共一致的标准时可以使参与项目的开发人员更容易了解项目中的代码、弄清程序的状况。使新的参与者可以很快的适应环 境防止部分参与者出于节省时间的需要自创一套风格并养成终生的习惯导致其它人在阅读时浪费过多的时间和精力。而且在一致的环境下也可以减少编码出 错的机会。缺陷是由于每个人的标准不同所以需要一段时间来适应和改变自己的编码风格暂时性的降底了工作效率。从使项目长远健康的发展以及后期更高的团 队工作效率来考虑暂时的工作效率降低是值得的也是必须要经过的一个过程。标准不是项目成功的关键但可以帮助我们在团队协作中有更高的效率并且更加顺利 的完成既定的任务。 程序员可以了解任何代码弄清程序的状况新人可以很快的适应环境防止新接触PHP的人出于节省时间的需要自创一套风格并养成终生的习惯防止新接触PHP的人一次次的犯同样的错误在一致的环境下人们可以减少犯错的机会程序员们有了一致的敌人PHP编码规范与原则 代码标记 PHP程序可以使用?php ?来界定 PHP 代码在HTML页面中嵌入纯变量时可以使用?php echo $variablename;?这样的形式。注意为了使代码进一步规范化和标准化从Discuz! X2版本起开始禁用? ?和?$variablename?这种速记形式。注释 注释是对于那些容易忘记作用的代码添加简短的介绍性内容。请使用 C 样式的注释“/* */”和标准 C 注释“//”。在Discuz!每一个程序文件头部中应放入相应SVN控制字串以方便SVN提交时自动更新$Id$例如 /*** [Discuz!] (C)2001-2099 Comsenz Inc.* This is NOT a freeware, use is subject to license terms** $Id$*/ 程序开发中难免留下一些临时代码和调试代码此类代码必须添加注释以免日后遗忘。所有临时性、调试性、试验性的代码必须添加统一的注释标记“//debug”并后跟完整的注释信息这样可以方便在程序发布和最终调试前批量检查程序中是否还存在有疑问的代码。例如$num 1;
$flag TRUE; //debug 这里不能确定是否需要对$flag进行赋值
if(empty($flag)) {//Statements
} 书写规则 缩进 每个缩进的单位约定是一个TAB(4个空白字符宽度)需每个参与项目的开发人员在编辑器(UltraEdit、EditPlus、Zend Studio等)中进行强制设定以防在编写代码时遗忘而造成格式上的不规范。本缩进规范适用于PHP、JavaScript中的函数、类、逻辑结构、循环等。大括号{}、if和switch 首括号与关键词同行尾括号与关键字同列if结构中else和elseif与前后两个大括号同行左右各一个空格。另外即便if后只有一行语句仍然需要加入大括号以保证结构清晰switch结构中通常当一个case块处理后将跳过之后的case块处理因此大多数情况下需要添加break。break的位置视程序逻辑与case同在一行或新起一行均可但同一switch体中break的位置格式应当保持一致。以下是符合上述规范的例子 if($condition) {switch($var) {case 1: echo ‘var is 1’; break;case 2: echo ‘var is 2’; break;default: echo ‘var is neither 1 or 2’; break;}
} else {switch($str) {case ‘abc’:$result ‘abc’;break;default:$result ‘unknown’;break;}
} 运算符、小括号、空格、关键词和函数 每个运算符与两边参与运算的值或表达式中间要有一个空格唯一的特例是字符连接运算符号两边不加空格左括号“(” 应和函数关键词紧贴在一起除此以外应当使用空格将“(”同前面内容分开右括号“)”除后面是“)”或者“.”以外其他一律用空格隔开它们除字符串中特意需要一般情况下在程序以及HTML中不出现两个连续的空格任何情况下PHP程序中不能出现空白的带有TAB或空格的行即这类空白行应当不包含任何TAB或空格。同时任何程序行尾也不能出现多余的TAB或空格。多数编辑器具有自动去除行尾空格的功能如果习惯养成不好可临时使用它避免多余空格产生每段较大的程序体上、下应当加入空白行两个程序块之间只使用1个空行禁止使用多行。程序块划分尽量合理过大或者过小的分割都会影响他人对代码的阅读和理解。一般可以以较大函数定义、逻辑结构、功能结构来进行划分。少于15行的程序块可不加上下空白行说明或显示部分中内容如含有中文、数字、英文单词混杂应当在数字或者英文单词的前后加入空格。根据上述原则以下举例说明正确的书写格式$result (($a 1) * 3 / 2 $num)).’Test’;
$condition ? func1($var) : func2($var);
$condition ? $long_statement : $another_long_statement;
if($flag) {//Statements//More than 15 lines}
showmessage(‘请使用 restore.php 工具恢复数据。’); 函数定义 参数的名字和变量的命名规范一致函数定义中的左小括号与函数名紧挨中间无需空格开始的左大括号与函数定义为同一行中间加一个空格不要另起一行具有默认值的参数应该位于参数列表的后面函数调用与定义的时候参数与参数之间加入一个空格必须仔细检查并切实杜绝函数起始缩进位置与结束缩进位置不同的现象例如符合标准的定义function authcode($string, $operation, $key ) {if($flag) {//Statement}//函数体
} 不符合标准的定义function authcode($string,$operation,$key )
{//函数体
} 引号 PHP中单引号和双引号具有不同的含义最大的几项区别如下 单引号中任何变量($var)、特殊转义字符(如“\t \r \n”等)不会被解析因此PHP的解析速度更快转义字符仅仅支持“\’”和“\\”这样对单引号和反斜杠本身的转义双引号中变量($var)值会代入字符串中特殊转义字符也会被解析成特定的单个字符还有一些专门针对上述两项特性的特殊功能性转义例如“\$”和“{$array[‘key’]}。这样虽然程序编写更加方便但同时PHP的解析也很慢数组中如果下标不是整型而是字符串类型请务必用单引号将下标括起正确的写法为$array[‘key’]而不 是$array[key]因为不正确的写法会使PHP解析器认为key是一个常量进而先判断常量是否存在不存在时才以“key”作为下标带入表达式 中同时出发错误事件产生一条Notice级错误。因此在绝大多数可以使用单引号的场合禁止使用双引号。依据上述分析可以或必须使用单引号的情况包括但不限于下述 字符串为固定值不包含“\t”等特殊转义字符数组的固定下标例如$array[‘key’]表达式中不需要带入变量例如$string ‘test’;而非$string “test$var”例外的在正则表达式(用于preg_系列函数和ereg系列函数)中Discuz!全部使用双引号这是为了人工分析和编写的方便并保持正则表达式的统一减少不必要的分析混淆。数据库SQL语句中所有数据必须加单引号无论数值还是字串以避免可能的注入漏洞和SQL错误。正确的写法为UPDATE cdb_members SET adminid’1’ WHERE username’$admin’ AND adminid’2’; 所有数据在插入数据库之前均需要进行addslashes()处理以免特殊字符未经转义在插入数据库的时候出现错误。Discuz!中所有通 过 GET, POST, FILE,取得的变量默认情况下已经使用了addslashes()进行了转义不必重复进行。如果数据处理必要(例如用于直接显示)可以使用 stripslashes() 恢复但数据在插入数据库之前必须再次进行转义。缓存文件中一般对缓存数据的值采用 addcslashes($string, ‘\’\\’)进行转义。Discuz!语言问题 在功能设计阶段当需要使用中文或者给出用户中文提示的时候可以直接在程序中插入简体中文文字待程序整理和测试阶段由专人进行语言分离工作功能说明性语言、短语一般不使用“。”或者其他标点符号作为结束文字中的标点符号应使用全角。但注意由于中英文模板与语言包问题功能说明性的语言中冒号使用半角”:”而不使用全角提示信息(用showmessage()和cpmsg()显示的)和使用技巧(如后台管理界面中的tips)等大篇幅文字中当中的标点符号应当遵循中文语法规则以使用全角中文标点为主结尾应当加入全角句号。尽管程序语言包是在最后整理阶段才进行提取但程序中直接写出的中文内容也应充分保证书面语的特征语言通顺、简洁、得体、无歧义。应彻底杜绝 认为直接写提示语言是临时性操作的想法反复推敲并总结之前提示语言的特征规范加以应用。良好的语言文字表达能力是每个优秀程序员必须具备的基本素 质之一。命名原则 命名是程序规划的核心。古人相信只要知道一个人真正的名字就会获得凌驾于那个人之上的不可思议的力量。只要你给事物想到正确的名字就会给你以及后来的人带来比代码更强的力量。名字就是事物在它所处的生态环境中一个长久而深远的结果。总的来说只有了解系统的程序员才能为系统取出最合适的名字。如果所有的命名都与其自然相适合则关系清晰含义可以推导得出一般人的推想也能在意料之中。就一般约定而言类、函数和变量的名字应该总是能够描述让代码阅读者能够容易的知道这些代码的作用。形式越简单、越有规则就越容易让人感知和理解。应该避免使用模棱两可晦涩不标准的命名。 变量、对象、函数名 变量、对象、函数名一律为小写格式除非必要单词之间一般不使用下划线“_”进行分割以标准计算机英文为蓝本杜绝一切拼音、或拼音英文混杂的命名方式变量命名只能使用项目中有据可查的英文缩写方式例如可以使用$data而不可使用$data1、$data2这样容易产生混淆的形式应当使用$threaddata、$postdata这样一目了然容易理解的形式可以合理的对过长的命名进行缩写例如$bio($biography)$tpp($threadsPerPage)前提是英文中有这样既有的缩写形式或字母符合英文缩写规范必须清楚所使用英文单词的词性在权限相关的范围内大多使用$allow***或$is***的形式前者后面接动词后者后面接形容词。常量 常量应该总是全部使用大写字母命名少数特别必要的情况下可使用划线来分隔单词PHP 的内建值 TRUE、FALSE 和NULL必须全部采用大写字母书写。变量的初始化与逻辑检查 任何变量在进行累加、直接显示或存储前必需进行初使化,例如 $number 0; //数值型初始化
$string ‘’; //字符串初始化
$array array(); //数组初始化 判断一个无法确定不知道是否已被赋值的变量时可用empty()或isset()而不要直接使用if($switch)的形式除非你确切的知道此变量一定已经被初始化并赋值。empty()和isset()的区别为 bool empty(mixed var)如果 var 是非空或非零的值则 empty() 返回 FALSE。换句话说””、0、”0″、NULL、FALSE、array()、var $var; 以及没有任何属性的对象都将被认为是空的如果 var 为空则返回 TRUE。bool isset(mixed var[, mixed var[, …]]) 如果 var 存在则返回 TRUE否则返回 FALSE。 如果已经使用 unset() 释放了一个变量之后它将不再是 isset()。若使用 isset() 测试一个被设置成 NULL 的变量将返回 FALSE。同时要注意的是一个 NULL 字节”\0″并不等同于 PHP 的 NULL 常数。判断一个变量是否为数组请使用is_array()这种判断尤其适用于对数组进行遍历的操作例如foreach()因为如果不事先判断foreach()会对非数组类型的变量报错判断一个数组元素是否存在可使用isset($array[‘key’])也可使用empty()两者异同见上。安全性 PHP中的变量不并不像C语言那样需要事先声明解释器会在第一次使用时自动创建他们同样类型也不需要指定解释器会根据上下文环境自动确定。 从开发人员的角度来看这无疑是一种极其方便的处理方法。一个变量被创建了就可以在程序中的任何地方使用。这导致的结果就是开发人员工经常不注意初始化 变量。因此为了提高程序的安全性我们不能相信任何没有明确定义的变量。所有的变量在定义使用前要初使化以防止恶意构造提交的变量覆盖程序中使用的变 量。兼容性 代码设计应当兼顾PHP 高低版本的特性当前应仍然以PHP 4.0.6作为最低通过平台尽量不使用高版本PHP 新增的函数、常数或者常量。如果使用只在高版本才具备的函数必须对其进行二次封装自动判断当前PHP版本并自行编写低版本下的兼容代码对于个别函数参数要求或者代码要求应当以较为严格的PHP版本为准除非必要不要使用PHP扩展模块中的函数。使用时应当加入必要的判断当服务器环境不支持此函数的时候进行必要的处理。文档和程序中的功能说明中也应加上兼容性说明。代码重用 代码的有效重用可以减少效率的损失与资源的浪费。在开发软件项目时为了避免重复劳动和浪费时间。开发人员应尽量提高现有代码的重用率同时将更多的精力用在新技术的应用和新功能的创新开发上面。 在需要多次使用代码并且对于您希望实现的任务没有可用的内置 PHP 函数时不吝啬定义函数或类。开发者须根据功能、调用情况将函数和类放置于相应的function或class中。超过3行实现相同功能的程序切勿在 不同程序中多次出现这是无法容忍和回避的问题在任何时候都不要出现同一个程序中出现两段或更多的相似代码或相同代码即便在不同程序中也应尽力避免。开发者应当总是有能力找到避免代码大段(超过10行)重复或类似的情况。需要强调的是本部分虽然篇幅较短但却是十分需要经验并将花费开发者大量时间和精力去进行优化的部分任何产品开发者必须时刻清楚和理解代码重用的重要性和必要性切实在增强产品效率、逻辑性和可读性上下功夫这是一名优秀软件开发者所必须具备的基本素质。其他细节问题 包含调用 包含调用程序文件请全部使用require_once以避免可能的重复包含问题包含调用缓存文件由于缓存文件无法保证100%正确打开请使用include_once或include。在必要时可以使用include_once或include的方式以忽略错误提示包含和调用代码中须以“./”或DISCUZ_ROOT.’./’开头应避免直接写程序文件名(例如require_once ‘x.php’;)的做法所有被包含和调用的程序文件包括但不限于程序、缓存或模板通常其不能被直接URL请求。Discuz!通过在./source/class /class_core.php中定义一个标记性常量IN_DISCUZ来判断程序是否被合法调用。因此在除了./source/class /class_core.php以外的任何一个被包含和调用的程序文件中需要包含以下内容以使得访问者无法直接通过URL请求该文件if(!defined(IN_DISCUZ)) {exit(Access Denied);
} 错误报告级别 在软件开发和调试阶段请使用error_reporting(E_ALL);作为默认的错误报告级别此级别最为严格能够报告程序中所有的错 误、警告和提示信息以帮助开发者检查和核对代码避免大多数安全性问题和逻辑错误、拼写错误。error_reporting()可以在 config/config_global.php中添加一行$_config[‘debug’] 1;debug值可以在0~2之前取值数值越大报错等级越高。在软件发布时请使用error_reporting(E_ERROR | E_WARNING | E_PARSE);作为默认的错误报告级别以利于用户使用并将无谓错误提示信息降至最低。数据库设计 字段 表和字段命名 表和字段的命名以前面《4.4命名原则》的约定为基本准则。所有数据表名称只要其名称是可数名词则必须以复数方式命名例如cdb_members(用户表)、cdb_posts(帖子表)存储多 项内容的字段或代表数量的字段也应当以复数方式命名例如params(parameters自定义Discuz!代码的参数个数)、 views(查看次数)、replies(回复次数)。当几个表间的字段有关连时要注意表与表之间关联字段命名的统一如cdb_threads表中的tid与cdb_posts表中的tid。代表id自增量的字段通常用以下几种形式 最常用的核心id或经常在URL中进行调用的尽量用简写的形式例如tid、pid、uid有功能性作用URL中偶尔用到的id使用全称的形式例如pluginid没有功能性作用只为管理和维护方便而设的id可以使用全称的形式也可只将其命名为id。所有与表、字段相关的命名请务必大量参考Discuz!现有字段的命名方式以保证命名的系统性和统一性。 字段结构 允许NULL值的字段数据库在进行比较操作时会先判断其是否为NULL非NULL时才进行值的必对。因此基于效率的考虑所有字段均不能为空即全部NOT NULL预计不会存储非负数的字段例如各项id、发帖数等必须设置为UNSIGNED类型。UNSIGNED类型比非UNSIGNED类型所能存储的正整数范围大一倍因此能获得更大的数值存储空间存储开关、选项数据的字段通常使用tinyint(1)非UNSIGNED类型少数情况也可能使用enum()结果集的方式。tinyint 作为开关字段时通常1为打开0为关闭-1为特殊数据例如N/A(不可用)高于1的为特殊结果或开关二进制数组合(详见Discuz!中相关代 码)MEMORY/HEAP类型的表中要尤其注意规划节约使用存储空间这将节约更多内存。例如cdb_sessions表中就将IP地址的存储拆分为4个tinyint(3) UNSIGNED类型的字段而没有采用char(15)的方式任何类型的数据表字段空间应当本着足够用不浪费的原则数值类型的字段取值范围见下表字段类型存储空间(b)UNSIGNED取值范围tinyint1否-128~127是0~255smallint2否-32768~32767是0~65535mediumint3否-8388608~8388607是0~16777215int4否-2147483648~2147483647是0~4294967295bigint8否-9223372036854775808~9223372036854775807是0~18446744073709551615SQL语句 所有SQL语句中除了表名、字段名称以外全部语句和函数均需大写应当杜绝小写方式或大小写混杂的写法。例如select * from cdb_members;是不符合规范的写法。很长的SQL语句应当有适当的断行依据JOIN、FROM、ORDER BY等关键字进行界定。通常情况下在对多表进行操作时要根据不同表名称对每个表指定一个1~2个字母的缩写以利于语句简洁和可读性。如下的语句范例是符合规范的$query $db-query(SELECT s.*, m.* FROM {$tablepre}sessions s, {$tablepre}members m WHERE m.uids.uid AND s.sid$sid); 性能与效率 定长与变长表 包含任何varchar、text等变长字段的数据表即为变长表反之则为定长表。 对于变长表由于记录大小不同在其上进行许多删除和更改将会使表中的碎片更多。需要定期运行OPTIMIZE TABLE以保持性能。而定长表就没有这个问题如果表中有可变长的字段将它们转换为定长字段能够改进性能因为定长记录易于处理。但在试图这样做之前应该考虑下列问题使用定长列涉及某种折衷。它们更快但占用的空间更多。char(n) 类型列的每个值总要占用n 个字节(即使空串也是如此)因为在表中存储时值的长度不够将在右边补空格而varchar(n)类型的列所占空间较少因为只给它们分配存储每个值所需要的空间每个值再加一个字节用于记录其长度。因此如果在char和varchar类型之间进行选择需要对时间与空间作出折衷变长表到定长表的转换不能只转换一个可变长字段必须对它们全部进行转换。而且必须使用一个ALTER TABLE语句同时全部转换否则转换将不起作用有时不能使用定长类型即使想这样做也不行。例如对于比255字符更长的串没有定长类型在设计表结构时如果能够使用定长数据类型尽量用定长的因为定长表的查询、检索、更新速度都很快。必要时可以把部分关键的、承担频繁访问的表拆 分例如定长数据一个表非定长数据一个表。例如Discuz!的cdb_members和cdb_memberfields表、cdb_forums和 cdb_forumfields表等。因此规划数据结构时需要进行全局考虑进行表结构设计时应当做到恰到好处反复推敲从而实现最优的数据存储体系。 运算与检索 数值运算一般比字符串运算更快。例如比较运算可在单一运算中对数进行比较。而串运算涉及几个逐字节的比较如果串更长的话这种比较还要多。如果串列的值数目有限应该利用普通整型或emum类型来获得数值运算的优越性。更小的字段类型永远比更大的字段类型处理要快得多。对于字符串其处理时间与串长度直接相关。一般情况下较小的表处理更快。对于定长表应该选 择最小的类型只要能存储所需范围的值即可。例如如果mediumint够用就不要选择bigint。对于可变长类型也仍然能够节省空间。一个 TEXT 类型的值用2 字节记录值的长度而一个LONGTEXT 则用4字节记录其值的长度。如果存储的值长度永远不会超过64KB使用TEXT 将使每个值节省2字节。结构优化与索引优化 索引能加快查询速度而索引优化和查询优化是相辅相成的既可以依据查询对索引进行优化也可以依据现有索引对查询进行优化这取决于修改查询或索引哪个对现有产品架构和效率的影响最小。索引优化与查询优化是多年经验积累的结晶在此无法详述但仍然给出几条最基本的准则。首先根据产品的实际运行和被访问情况找出哪些SQL语句是最常被执行的。最常被执行和最常出现在程序中是完全不同的概念。最常被执行的SQL 语句又可被划分为对大表(数据条目多的)和对小表(数据条目少的)的操作。无论大表或小表有可分为读(SELECT)多、写 (UPDATE/INSERT)多或读写都多的操作。对常被执行的SQL语句而言对大表操作需要尤其注意 写操作多的通常可使用写入缓存的方法先将需要写或需要更新的数据缓存至文件或其他表定期对大表进行批量写操作例如Discuz!中点击数 延迟更新机制就是依据此原理实现。同时应尽量使得常被读写的大表为定长类型即便原本的结构中大表并非定长。大表定长化可以通过改变数据存储结构和 数据读取方式将一个大表拆成一个读写多的定长表和一个读多写少的变长表来实现读操作多的需要依据SQL查询频率设置专门针对高频SQL语句的索引和联合索引。而小表就相对简单加入符合查询要求的特定索引通常效果比较明显。同时定长化小表也有益于效率和负载能力的提高。字段比较少的小定长表甚至可以不需要索引。其次看SQL语句的条件和排序字段是否动态性很高(即根据不同功能开关或属性SQL查询条件和排序字段的变化很大的情况)动态性过高的SQL语句是无法通过索引进行优化的。惟一的办法只有将数据缓存起来定期更新适用于结果对实效性要求不高的场合。MySQL索引常用的有PRIMARY KEY、INDEX、UNIQUE几种详情请查阅MySQL文档。通常在单表数据值不重复的情况下PRIMARY KEY和UNIQUE索引比INDEX更快请酌情使用。事实上索引是将条件查询、排序的读操作资源消耗分布到了写操作中索引越多耗费磁盘空间越大写操作越慢。因此索引决不能盲目添加。对字段索引与否最根本的出发点依次仍然是SQL语句执行的概率、表的大小和写操作的频繁程度。查询优化 MySQL中并没有提供针对查询条件的优化功能因此需要开发者在程序中对查询条件的先后顺序人工进行优化。例如如下的SQL语句SELECT * FROM table WHERE a’0’ AND b’1’ ORDER BY c LIMIT 10; 事实上无论a’0’还是b’1’哪个条件在前得到的结果都是一样的但查询速度就大不相同尤其在对大表进行操作时。开发者需要牢记这个原则最先出现的条件一定是过滤和排除掉更多结果的条件第二出现的次之以此类推。因而表中不同字段的值的分布对查询速度有着很大影响。而ORDER BY中的条件只与索引有关与条件顺序无关。除了条件顺序优化以外针对固定或相对固定的SQL查询语句还可以通过对索引结构进行优化进而实现相当高的查询速度。原则是在大多数情况 下根据WHERE条件的先后顺序和ORDER BY的排序字段的先后顺序而建立的联合索引就是与这条SQL语句匹配的最优索引结构。尽管事实的产品中不能只考虑一条SQL语句也不能不考虑空间占 用而建立太多的索引。同样以上面的SQL语句为例最优的当table表的记录达到百万甚至千万级后可以明显的看到索引优化带来的速度提升。依据上面条件优化和索引优化的两个原则当table表的值为如下方案时可以得出最优的条件顺序方案字段a字段b字段c171128103913最优条件b’1’ AND a’0’最优索引INDEX abc (b, a, c) 原因b’1’作为第一条件可以先过滤掉75%的结果。如果以a’0’作为第一条件则只能先过滤掉25%的结果注意 字段c由于未出现于条件中故条件顺序优化与其无关最优索引由最优条件顺序得来而非由例子中的SQL语句得来索引并非修改数据存储的物理顺序而是通过对应特定偏移量的物理数据而实现的虚拟指针EXPLAIN语句是检测索引和查询能否良好匹配的简便方法。在phpMyAdmin或其他MySQL客户端中运行EXPLAIN查询语句例 如EXPLAIN SELECT * FROM table WHERE a’0’ AND b’1’ ORDER BY c;这种形式即使得开发者无需模拟上百万条数据也可以验证索引是否合理相关细节请参考MySQL说明。值得提出的是Using filesort是最不应当出现的情况如果EXPLAIN得出此结果说明数据库为这个查询专门建立了一个用以缓存结果的临时表文件并在查询结束后删 除。众所周知硬盘I/O速度始终是计算机存储的瓶颈因此查询中应当尽全力避免高执行频率的SQL语句使用filesort。尽管开发者永远都不可 能保证产品中的全部SQL语句都不会使用filesort。限于篇幅本文档远远没有涵盖数据库优化的方方面面例如联合索引与普通索引的可重用性、JOIN连接的索引设计、MEMORY/HEAP表 等。数据库优化实际上就是在很多因素和利弊间不断权衡、修改惟有在成功与失败经验中反复推敲才能得出的经验这种经验往往就是最难能可贵和价值连城的。兼容性问题 由于MySQL 3.23至5.0的变化很大因此程序中尽量不使用特殊的SQL语句以免带来兼容性问题并给数据库移植造成困难。通常在MySQL 4.1以上版本Discuz!应使用相当的字符集来存储例如GBK/BIG5/UTF-8。传统的latin1编码虽然有一定的兼容性但仍然不是推 荐的选择。使用相应非默认字符集时程序每次运行时需要使用SET NAMES ‘character_set’;来规定连接、传输和结果的字符集。Mysql 5.0以上新增了数种SQL_MODE默认的SQL_MODE依服务器安装设置不同而不同因此程序每次运行时需要使用SET SQL_MODE’’;来规定当前的SQL模式。模板设计 代码标记 HTML代码标记一律采用小写字母形式杜绝任何使用大写字母的方式模板中所有的逻辑体如{if}、{loop}等必须前后使用HTML注释()即类似的形式。事实上Discuz!模板编译器是支持不加 HTML注释的逻辑体写法的但加入注释可以使得模板可读性更好同时方便用户使用DreamWeaver或FrontPage等对模板进行修改。在HTML标记中使用的逻辑体无需使用HTML注释()即input type”text”{if xxx} value”1”{/if} /书写规则 HTML 所有HTML标记参数赋值需使用双引号包含例如应当使用input type”text” name”test” value”ok” /,而绝对不能使用input typetext nametest valueok /。在任何情况下产品中的模板文件必须采用手写HTML代码的方式而绝对不能使用DreamWeaver、FrontPage等自动网页制作工具进行撰写或修改。非成对标记必须以“/”结尾如 、input …/,input / 标记的属性必须按照以下顺序书写input type”” name”” id”” class”” … /变量 模板中使用的变量依据作用和出现位置不同分为几种方式 逻辑体中即被包围起来的部分例如这种形式其中的变量书写规范与PHP程序中完全一致模板内容中即未被包围起来的部分与PHP程序中最大的不同是对数组字符串类型下标无需加入单引号因为Discuz!模板编译器会在对模板进行编译时将这部分的单引号自动加入。偶尔的开发者需要使用{}将变量括起来以免出现模板编译错误可能的情况如下 变量前后含有中括号的或其他敏感字符的(包括但不限于“$”、“’”等)正确的写法为descriptionnew[{$buddy[buddyid]}]数组的下标为变量的正确的写法为{$extcredits[$creditstrans][title]}其他变量十分复杂的情况。语言元素 Discuz!模板编译器可以解析对应于./templates/default/templates.lang.php(以默认模板为例)的语 言元素。在模板中调用相应语言元素的代码为{lang item}其中item为在templates.lang.php中定义的语言元素名。缩进 在Discuz!的*.htm模板文件中由于具备逻辑结构故不考虑任何HTML本身的缩进所有缩进均意为着逻辑上的缩进结构。缩进采用TAB方式不使用空格作为缩进符号仅需适当断行即可。例如!--{loop $threadlist $thread}--table cellspacing”0” cellspadding”0” border”0”trtd$thread[message]/tr/td/table
!--{/loop}-- 文件与目录 文件命名 所有包含PHP代码的程序文件或半程序文件应以小写.php作为扩展名而不要使用.phtml、.php3、.inc、.class等作为扩展名。普通程序能够被URL直接调用的程序例如home.php、index.php、forum.php直接使用程序名.php的方式命名函数库和类库程序分别以小写function_xxxx.php和class_xxxx.php的格式命名书写。函数库和类库程序只能被其他程序引用而不能独立运行。其中不能包含任何流程性的、不属于任何函数或类的程序代码。流程性程序以小写.inc.php作为扩展名。只能被其他程序引用而不能独立运行。其中不能包含任何函数或类代码的程序代码。模板源文件以小写.htm作为扩展名。模板源文件按照Discuz!模板编码规则进行编写不是可以执行的程序而只能被Discuz!模板编译器所解析放置于./templates/default或./templates下的其他模板目录下。模板目标文件模板文件被编译后自动生成的目标程序以小写.tpl.php作为扩展名存放于./data/template目录下。语言包文件 以小写lang_xxxx.php格式命名只能存放模板或程序使用的语言包信息。模板语言包存放在对应模块名下的lang_template.php例如家园的模板语言包source\language\home\lang_template.php缓存文件此类文件为系统自动生成以cache_xxx.php、usergroup_xxx.php、style_xxx.php等类似形式命名存放于./data/cache目录下。目录命名 Discuz!目录命名以前面《4.4命名原则》的约定为基本准则。在可能的情况下多以复数形式出现如./templates、./images等。由于目录数量较少因此目录命名大多是一些习惯和约定俗成开发人员如需新建目录应与项目组成员进行磋商达成一致后方可实施。空目录索引 请在所有不包含普通程序(即能够被URL直接调用的程序)的目录中放置一个1字节的index.htm文件内容为一个空格。几乎除 Discuz!根目录以外所有目录都属于这一类型因此开发者需要在这些目录全部放入空index.htm文件以避免当http服务器的 Directory Listing打开时服务器文件被索引和列表。附件目录等敏感目录要在程序中实现相应功能当新建下级目录时必须自动写入一个空的index.htm文件以避免新建目录被索引的问题。转载于:https://www.cnblogs.com/lvshuocool/p/4834892.html
