WordPress 程序撰写标准

2008年05月01日 WordPress, 学习随笔 暂无评论 阅读 1 次

WordPress Coding Standards
From WordPress Chinese
Jump to: navigation, search
Some legacy parts of the WordPress code structure for PHP markup are inconsistent in their style. WordPress is working to gradually improve this by helping users maintain a consistent style so the code can remain clean and easy to read at a glance.

Keep the following points in mind when writing code for WordPress, whether for core programming code, Plugins, or WordPress Themes. The guidelines are similar to Pear standards in many ways, but differs in some key respects.

Single and double quotes
When possible, single and double quotes should be used when appropriate. If you're not evaluating anything in the string, use single quotes. You should almost never have to escape HTML quotes in a string, because you can just alternate your quoting style, like so:

echo "<a title="$linktitle" href="$link">$linkname</a>";

echo '<a title="Yeah yeah!" href="/static/link">Link name</a>';

The only exception to this is JavaScript, which sometimes requires double or single quotes. Text that goes into attributes should be run through Texturize so that single or double quotes do not end the attribute value and invalidate the XHTML.
Your indentation should always reflect logical structure. Use real tabs and not spaces, as this allows the most flexibility across clients.
Brace Style
Brace styles, when used correctly, makes for easier reading. An example from the Pear site:
if ( (condition1) || (condition2) ) {
} elseif ( (condition3) && (condition4) ) {
} else {
} // end blah
Furthermore if you have a really long block, consider if it can be broken into two or more shorter blocks or function. If you consider such a long block unavoidable, please put a short comment at the end so people can tell at glance what that ending brace ends -- typically this is appropriate for a logic block, longer than about 35 rows, but any code that's not intuitively obvious can be commented.
include_once vs. require_once
Learn the difference between include_once and require_once, and use each as appropriate. To quote the php manual page on include(): "The two constructs are identical in every way except how they handle failure. include() produces a Warning while require() results in a Fatal Error." Fatal errors stop script execution.
Regular expressions
Perl compatible regular expressions (PCRE, preg_ functions) should be used in preference to their POSIX counterparts.
No Shorthand PHP
Never use shorthand PHP start tags (< ? ... ?>). Always use full PHP tags (< ?php ... ?>).
Space Usage
Always put spaces after commas and on both sides of logical and assignment operators like "x == 23", "foo && bar", "array(1, 2, 3)", , as well as on both sides of the opening and closing parenthesis of if, elseif, foreach, for and switch blocks (e.g. foreach ( $foo as $bar ) { ...)
Formatting SQL statements
When formatting SQL statements you may break it into several lines and indent if it is sufficiently complex to warrant it. Most statements work well as one line though. Always capitalize the SQL parts of the statement like UPDATE or WHERE.
Database Queries
Avoid touching the database directly. If there is a defined function that can get the data you need, use it. Database abstraction (using functions instead of queries) helps keep your code forward-compatible and, in cases where results are cached in memory, it can be many times faster. If you must touch the database, get in touch with some developers by posting a message to the wp-hackers mailing list. They may want to consider creating a function for the next WordPress version to cover the functionality you wanted.
Variables, functions, and operators
If you don't use a variable more than once, don't create it. This includes queries. Always use the wpdb Class of functions when interacting with the database.
Ternary operators are fine, but always have them test if the statement is true, not false. Otherwise it just gets confusing.
// GOOD example:
// (if statement is true) ? (do this) : (if false, do this);
$alert = ('1.5.1' == $version) ? 'This version is 1.5.1' : 'This version is NOT 1.5.1';

// BAD example:
// (if statement is false) ? (do this) : (if true, do this);
$alert = ('1.5.2' != $version) ? 'This version is NOT 1.5.2' : 'This version is 1.5.2';
Another important point in the above example, when doing logical comparisons always put the variable on the right side, like above. If you forget an equal sign it'll throw a parse error instead of just evaluating true and executing the statement. It really takes no extra time to do, so if this saves one bug it's worth it.


Copyright © 浩然东方 保留所有权利.   Theme  Ality 07032740