xunwap

WordPress代码阅读体会

admin — Fri, 14 Jan 2011 14:35:34 +0000

最近在阅读WordPress-3.0.4的源代码。总的感觉是代码结构清晰，简单明了。当然，最深的感触还是WordPress代码中的文档和注释–非常详细。WordPress的代码中详细记录了每一个模块的功能，变更历史；每一个class的功能，作用范围；每一个函数的功能，接口参数，以有返回值…从WordPress源代码的读者方面来说，有了如此丰富的文档和注释，阅读WordPress的代码是一件相对容易和有趣的事情。

从WordPress项目本身来说，对于一个新加入的开发者来说，有如此详细的文档和注释，即使在没有其它的成员的帮助的指导的前提下，新加入的成员也能很容易地从中了解WordPress的整体架构和逻辑流程。这一点，对于WordPress这个优秀的开源项目的发展壮大也是至关重要的。

很多不喜欢写注释和文档的开发者总喜欢说: “代码就是最好的注释，我的代码是自解释的，所以文档不是必需的…”。能做到上述三种自然是好的，但是这并不能代替文档和注释。对于一个大的项目，如果没有文档，一个新手可能需要很长时间才能融入；如果没有注释，对于大部分人来说，自己亲手写的功能模块，在半年之后，可能自己都不让识了，自已都搞不明白其中的逻辑和流程。要知道，文字和图像用于展示信息的能力比代码要强很多倍，所以，有了文档和注释，你能以更快的速度了解一份新的代码。文档和注释，于人于已都是善举。

本站原创文章，转载请注明出处。

RSS 阅读器: FeedDemon

admin — Thu, 13 Jan 2011 15:27:30 +0000

使用RSS来订阅一些比较好的博客是获取信息的一种好方式，为了使这种订阅更加有效，一个好的订阅工具是必不可少的了。

有比较多的RSS阅读器，比较有代表性的是: 基于Web的Google Reader和基于桌面的FeedDemon。

基于Web的Google Reader功能与FeedDemon类似，不过由于是基于Web的，所以操作的流畅性不如基于桌面的FeedDemon。

FeedDemon也是一个免费软件，主要的特色功能如下，推荐使用:

Google Reader Synchronization
Use FeedDemon at home, your office, or anywhere you go and keep your feeds, tags and shared items synched between locations.

Sharing
FeedDemon’s simple single-click sharing lets your friends subscribe to your favorite articles.

Tagging
Assign your own keywords to items, making it easy to classify and locate articles you’ve previously read.

Watches
Tell FeedDemon to let you know when your keywords appear in any feed you’re subscribed to.

Search Feeds
Get alerted when your keywords appear in any feed, regardless of whether you’re subscribed to it.

Podcasts
Let FeedDemon automatically download audio files and copy them to your iPod or other media device.

本站原创文章，转载请注明出处。

Linux Manpages CHM 下载

admin — Tue, 11 Jan 2011 16:02:37 +0000

在Windows下通过SSH连接到远程的Linux主机上进行开发时，如果需要查看对应的API文档，可以使用 man 命令。但是，

既然是在基于GUI的Windows下，使用集成的文档手册进行查阅将更方便，也更快捷。好在有大量的经过整理的Linux API手册，

这里推荐一本比较详尽且与囊括了最新的Linux API的一本Manpages整理成的CHM手册。

猛击此处下载

本站原创文章，转载请注明出处。

MySQL –force 参数含义

admin — Tue, 11 Jan 2011 15:39:02 +0000

在使用类似于: “mysql –database=xxx < sql_file.sql” 的形式来将SQL语句批量导入到MySQL中时，如果此文件中的某一条SQL在入库的过程中发生错误，那么”mysql –database=xxx < sql_file.sql“命令会停止运行。

因此，这条引发错误的SQL之后的所有的SQL都将无法导入数据库。如果我们需要忽略导入过程中的SQL，并继续执行其后的所有的SQL直到全部导入完成，那么就需要在上述命令中加入”–force”参数，也即是导入命令为: “mysql –force –database=xxx < sql_file.sql“。

大多数情况下并不建议在批量导入过程中使用”–force”参数，因为如果忽略了其中本不应该发生的SQL错误，那么可以导致导入的数据发生错误。

本站原创文章，转载请注明出处。

PHP 中文文档下载

admin — Mon, 10 Jan 2011 13:34:25 +0000

PHP官方网站上的中文文档由于更新速度过慢，导致中文文档与英文文档之间的更新进度差距太多，使得从其中文文档中无法获得PHP文档中最新的信息和说明。好在现在有一份新的PHP中文文档，由HonestQiao维护，文档中带最新评论。PHP中文文档托管在google code上，其更新记录如下:

1. 最新PHP中文/英文手册，每周SVN同步到最新版本
2. 整合在线评论信息，蕴含巨大宝藏，学习进阶必备
3. CHM格式，方便随身携带，可与其他软件完美配合使用
4. 导航详细，索引完整，搜索方便
5. 需求征集，打造最易用PHP中文CHM手册

一、更新日志：ChangeLog
0. 2007年10月5日，开始提供本CHM手册
1. 2008年3月19日，因官方问题，老版本暂停继续更新
2. 2010年8月1日，准备新版本，学习最新资料，准备代码和处理脚本
3. 2010年8月5日，2010演示版V0.1提供测试，基本整合最新手册和评论
4. 2010年8月11日，2010演示版V0.2提供测试，样式修改基本完善
5. 2010年8月12日，2010演示版V0.3提供测试，版式完善，加上了CHM导航目录和索引，可供正式使用
6. 2010年8月17日，2010演示版V0.4提供测试，修正编码问题，可供Windows/CHM、ChmSee、iCHM等完好好使用！
7. 2010年8月29日，2010演示版V0.5提供测试，加入在线中文和英文手册的连接，提供英文手册CHM整合评论版。
8. 2010年9月2日，2010演示版V0.6提供测试，特别纪念PHP手册中文翻译补完计划手册首次提交 PHP官方SVN。
9. 2010年9月9日，2010演示版V0.7提供测试，评论内PHP代码高亮，并加入手册新版本更新提醒功能（下次更新后，即可自动提示）。
10. 2010年9月18日，2010演示版V0.8提供测试，9.18纪念版。
11. 2010年9月26日，2010演示版V0.9提供测试
12. 2010年10月2日，正在完善相关处理脚本和程序，为正式发布做准备；因手册本身无实质变化，暂不上传本周版本！
13. 2010年10月10日，2010演示版V0.9.2提供测试
14. 2010年11月12日，2010演示版V0.9.3提供测试，开始修复手册中过期内容
15. 2010年11月29日，2010演示版V0.9.4提供测试，修复大量内部跳转链接问题
16. 2010年12月10日，2010演示版V0.9.5提供测试，纪念PHP5.3.4发布
17. 2011年1月1日，V0.9.6提供测试，元旦快乐

二、当前问题列表：BUG
1. CHM左则目录没有目录细节：已处理
2. CHM左则索引基本没有：已处理
3. CHM导航信息与CHM内容编码不一致，导致部分chm查看器乱码：已处理
4. xCHM查看时导航乱码（主要因为xCHM自身问题，望各位提供解决方法）

三、当前需求列表：TODO
1. 评论内PHP代码没有高亮处理：已处理[/color[
2. 每个页面加上到对应在线英文manual网址的连接：已处理
3. 加入更新手册后，自动提醒功能：已处理

四、感谢测试（部分人员，其他未列出请见谅）：Thanks
jayeeliu@gmail.com、QQ/50753256、QQ/496995561、QQ/307664144、QQ/258133984、QQ/77304226

五、说明：More
1. 因为属于演示版，所以可能存在问题，例如可能版式、乱码等，但正在全力完善！
2. 请协助改进，与 http://docs.php.net/manual/en/index.php 对比测试
3. 如有问题，敬请告知，多谢了！
4. 反馈请致信 honestqiao@163.com，标题【PHP手册反馈】；
　　亦可通过QQ/5601680、MSN/honestqiao@hotmail.com反馈
5. 一旦测试反馈和修改完善，就进入正式发布队列，每周更新
6. 下载后如打开无法正常查看，请从鼠标右键查看属性，点击解除锁定即可

六、友情推荐：Friend
1. Coreseek开源中文检索引擎，http://www.coreseek.cn/，基于Sphinx，专业针对中文应用，MySQL绝配！

PHP中文文档下载

本站原创文章，转载请注明出处。

C++ String Library

admin — Sun, 09 Jan 2011 14:19:29 +0000

用std::string来代替char*作为字符串处理的方式在现代的C++开发中已是约定俗成的规则了。不过std::string的公有成员函数的功能是很有限的，而且操作起来并不是很方便，借助于 std::algorithms 来操作std::string时，因为std::algorithms需要面对的是容器的通用操作，也以，也有部分我们所需要的std::string操作无法通过std::algorithms来实现。好在 String Algorithms Library 为std::string弥补了众多在操作上的不足之处。先看看 String Algorithms Library 的函数:

Algorithms

Table 21.1. Case Conversion

Algorithm name	Description	Functions
`to_upper`	Convert a string to upper case	`to_upper_copy()` `to_upper()`
`to_lower`	Convert a string to lower case	`to_lower_copy()` `to_lower()`

Table 21.2. Trimming

Algorithm name	Description	Functions
`trim_left`	Remove leading spaces from a string	`trim_left_copy_if()` `trim_left_if()` `trim_left_copy()` `trim_left()`
`trim_right`	Remove trailing spaces from a string	`trim_right_copy_if()` `trim_right_if()` `trim_right_copy()` `trim_right()`
`trim`	Remove leading and trailing spaces from a string	`trim_copy_if()` `trim_if()` `trim_copy()` `trim()`

Table 21.3. Predicates

Algorithm name	Description	Functions
`starts_with`	Check if a string is a prefix of the other one	`starts_with()` `istarts_with()`
`ends_with`	Check if a string is a suffix of the other one	`ends_with()` `iends_with()`
`contains`	Check if a string is contained of the other one	`contains()` `icontains()`
`equals`	Check if two strings are equal	`equals()` `iequals()`
`lexicographical_compare`	Check if a string is lexicographically less then another one	`lexicographical_compare()` `ilexicographical_compare()`
`all`	Check if all elements of a string satisfy the given predicate	`all()`

Table 21.4. Find algorithms

Algorithm name	Description	Functions
find_first	Find the first occurrence of a string in the input	`find_first()` `ifind_first()`
find_last	Find the last occurrence of a string in the input	`find_last()` `ifind_last()`
find_nth	Find the nth (zero-indexed) occurrence of a string in the input	`find_nth()` `ifind_nth()`
find_head	Retrieve the head of a string	`find_head()`
find_tail	Retrieve the tail of a string	`find_tail()`
find_token	Find first matching token in the string	`find_token()`
find_regex	Use the regular expression to search the string	`find_regex()`
find	Generic find algorithm	`find()`

Table 21.5. Erase/Replace

Algorithm name	Description	Functions
replace/erase_first	Replace/Erase the first occurrence of a string in the input	`replace_first()` `replace_first_copy()` `ireplace_first()` `ireplace_first_copy()` `erase_first()` `erase_first_copy()` `ierase_first()` `ierase_first_copy()`
replace/erase_last	Replace/Erase the last occurrence of a string in the input	`replace_last()` `replace_last_copy()` `ireplace_last()` `ireplace_last_copy()` `erase_last()` `erase_last_copy()` `ierase_last()` `ierase_last_copy()`
replace/erase_nth	Replace/Erase the nth (zero-indexed) occurrence of a string in the input	`replace_nth()` `replace_nth_copy()` `ireplace_nth()` `ireplace_nth_copy()` `erase_nth()` `erase_nth_copy()` `ierase_nth()` `ierase_nth_copy()`
replace/erase_all	Replace/Erase the all occurrences of a string in the input	`replace_all()` `replace_all_copy()` `ireplace_all()` `ireplace_all_copy()` `erase_all()` `erase_all_copy()` `ierase_all()` `ierase_all_copy()`
replace/erase_head	Replace/Erase the head of the input	`replace_head()` `replace_head_copy()` `erase_head()` `erase_head_copy()`
replace/erase_tail	Replace/Erase the tail of the input	`replace_tail()` `replace_tail_copy()` `erase_tail()` `erase_tail_copy()`
replace/erase_regex	Replace/Erase a substring matching the given regular expression	`replace_regex()` `replace_regex_copy()` `erase_regex()` `erase_regex_copy()`
replace/erase_regex_all	Replace/Erase all substrings matching the given regular expression	`replace_all_regex()` `replace_all_regex_copy()` `erase_all_regex()` `erase_all_regex_copy()`
find_format	Generic replace algorithm	`find_format()` `find_format_copy()` `find_format_all()` `find_format_all_copy()()`

Table 21.6. Split

Algorithm name	Description	Functions
find_all	Find/Extract all matching substrings in the input	`find_all()` `ifind_all()` `find_all_regex()`
split	Split input into parts	`split()` `split_regex()`
iter_find	Iteratively apply the finder to the input to find all matching substrings	`iter_find()`
iter_split	Use the finder to find matching substrings in the input and use them as separators to split the input into parts	`iter_split()`

Table 21.7. Join

Algorithm name	Description	Functions
join	Join all elements in a container into a single string	`join`
join_if	Join all elements in a container that satisfies the condition into a single string	`join_if()`

Boost.String_Algo 的函数功能是相当的丰富了，也简便易用。所以可以在开发过程中大量使用。

BTW:有很多的人都排斥Boost，在一开始的时候我也不使用Boost，因为有太多的人建议我不要用。后来我还是使用了Boost，而且越用越喜欢，也越发感觉到Boost是一个多么灵活，高效，强大的C++ Library;也体会到了为什么可以称Boost具有”工业强度”。在这里，我建议那些不愿意使用Boost的朋友去使用一下Boost，也许你们是听别人建议不要用Boost，也许是自己不愿意使用Boost，但你们一定要去试用Boost中的一些可能用得上的Library，也许用了之后你们的看法会有所改变，也许你们会有不同的发现

本站原创文章，转载请注明出处。

PHP: Google Protocol Buffer

admin — Sat, 08 Jan 2011 15:27:58 +0000

作为通用的协议数据包序列化/反序列化工具，灵活高效的google protocol buffer以众多的优化力压大量的序列化工具和机制: XML,json…对于大规模的服务，系统之间由多个模块构成，由多种开发语言来协作完成系统中不同的部分。在这种情况下，有一个问题需要解决，那就是如何设计一种通用的数据序列化和反序列化的机制使得可以在系统的多个模块，多种开发语言中进行灵活高效的数据通信。基于google protocol buffer的特点，这种情况下选择google protocol buffer是一个很好的方向。当前的google protocol buffer仅支持: C++,Java,Python。PHP作为WEB开发的主力居然没有得到google protocol buffer的官方支持实在是有一些遗憾。好在开源的力量是巨大的，当前就有一个google protocol buffer支持PHP的接口实现:pb4php。

使用方法:
// .proto文件如下:

message Person
{
required string name = 1;
required int32 id = 2;
optional string email = 3;

enum PhoneType {
MOBILE = 0;
HOME = 1;
WORK = 2;
}

message PhoneNumber {
required string number = 1;
optional PhoneType type = 2 [default = HOME];
}
// a simple comment
repeated PhoneNumber phone = 4;
optional string surname = 5;
}

message AddressBook {
repeated Person person = 1;
}

// 序列化操作:

$book = new AddressBook();
$person = $book->add_person();
$person->set_name('Kordulla');
$person->set_surname('Nikolai');

$phone_number = $person->add_phone();
$phone_number->set_number('49');
$phone_number->set_type(Person_PhoneType::WORK);

$phone_number = $person->add_phone();
$phone_number->set_number('171');
$phone_number->set_type(Person_PhoneType::MOBILE);

// serialize
$string = $book->SerializeToString();

// write it to disk
file_put_contents('adressbook.pb', $string);

// 反序列化操作:

$string = file_get_contents('./test.pb');

// Just read it
$book = new AddressBook();
$book->parseFromString($string);

var_dump($book->person_size());
$person = $book->person(0);
var_dump($person->name());
var_dump($person->surname());
var_dump($person->phone(0)->number());
var_dump($person->phone(0)->type());
var_dump($person->phone(1)->number());
var_dump($person->phone(1)->type());

本站原创文章，转载请注明出处。

紧急PHP版本升级

admin — Fri, 07 Jan 2011 12:46:26 +0000

最近，PHP脚本语言中新发现的一个BUG: 当PHP执行转换超大浮点数的代码时，可能导致服务器宕机，这对基于PHP的网站的安全产生了一定的影响。这一错误只影响版本号为5.2和5.3的 PHP 发行版，并且只在使用 X87 指令集的32位英特尔CPU上出现。

在命令行执行如下代码即可测试您的系统当前版本的PHP是否受此BUG影响:

<?php
/*
  +----------------------------------------------------------------------+
  | PHP Version 5                                                        |
  +----------------------------------------------------------------------+
  | Copyright (c) 2011 The PHP Group                                     |
  +----------------------------------------------------------------------+
  | This source file is subject to version 3.01 of the PHP license,      |
  | that is bundled with this package in the file LICENSE, and is        |
  | available through the world-wide-web at the following url:           |
  | http://www.php.net/license/3_01.txt                                  |
  | If you did not receive a copy of the PHP license and are unable to   |
  | obtain it through the world-wide-web, please send a note to          |
  | license@php.net so we can mail you a copy immediately.               |
  +----------------------------------------------------------------------+
  | Author: Johannes Schlueter                         |
  +----------------------------------------------------------------------+
*/

if (PHP_SAPI != 'cli') {
    die("Please run this test from CLI!\n");
}

ini_set('display_errors', 1);
ini_set('output_buffering', 0);
error_reporting(-1);
if (!ini_get('safe_mode')) {
    set_time_limit(1);
}

echo "Testing float behaviour. If this script hangs or terminates with an error ".
     "message due to maximum execution time limit being reached, you should ".
     "update your PHP installation asap!\n";
echo "For more information refer to .\n";
$d = (double)"2.2250738585072011e-308";
echo "Your system seems to be safe.\n";
?>

如果上述代码证实您的系统中当前的PHP版本受此BUG影响，强烈建议升级PHP到BUG修复版本PHP-5.3.5。

本站原创文章，转载请注明出处。

Visual Studio 2008 安装 WTL

admin — Thu, 06 Jan 2011 13:35:21 +0000

WTL命名为: Windows Template Library。当前的最新版本为8.1。

WTL是一个类似于MFC的windows下的界面库，基于模板的形式构造，功能齐全但不如MFC功能多样，主要用于GUI界面开发，不包含Socket,File,Process…等相关的Windows API的封闭。但WTL整体架构简洁，易于使用，所开发的应用程序在不同的机器上运行时也更通畅(不需要类似于MFC开发的应用程序需要在使用的机器上安装对应的动态连接库)。整个WTL库使用与Boost库相似的方式来发布:即所有的库代码都是以头文件的形式来提供，使用WTL时直接在包含文件的路径中添加WTL的include路径即可使用，简洁方便。

下面介绍WTL在Visual Studio 2008下的安装方法:

首先，将WTL的安装包解压到指定路径，如: D:\Development。

然后，执行”AppWiz\setup90.js”文件，即可将WTL集成到Visual Studio 2008中。

最后，在Vistual Studio 2008中菜单栏中: “Tools->Options->Projects and Solutions->VC++ Directories”，将WTL的include目录添加到其中即可。

如果需要在Visual Studio 2003/Visual Studio 2005中安装WTL，那么在第二步中执行”AppWiz\setup70.js”/”AppWiz\setup80.js” 即可。

本站原创文章，转载请注明出处。

The Linux Programming Interface 下载

admin — Thu, 06 Jan 2011 13:12:17 +0000

在Linux/Unix下开发，是一定要读一下大名鼎鼎的《Advanced Programming in the UNIX Environment》，对于Linux/Unix下开发的方方面面这本书都有介绍。堪称Linux/Unix下开发的经典入门书籍。

今天，要向大家介绍另外一本最近面世的Linux/Unix环境下的编程书籍《The Linux Programming Interface》，从该书的总体内容和介绍来看，这本书将是《Advanced Programming in the UNIX Environment》之后又一本经典的入门书籍和参考手册。这本书主要包含如下内容:

Preface
1 History and Standards
2 Fundamental Concepts
3 System Programming Concepts
4 File I/O: The Universal I/O Model
5 File I/O: Further Details
6 Processes
7 Memory Allocation
8 Users and Groups
9 Process Credentials
10 Times and Dates
11 System Limits and Options
12 Retrieving System and Process Information
13 File I/O Buffering
14 File Systems
15 File Attributes
16 Extended Attributes
17 Access Control Lists
18 Directories and Links
19 Monitoring File Events with inotify
20 Signals: Fundamental Concepts
21 Signals: Signal Handlers
22 Signals: Advanced Features
23 Timers and Sleeping
24 Process Creation
25 Process Termination
26 Monitoring Child Processes
27 Program Execution
28 Process Creation and Program Execution in More Detail
29 Threads: Introduction
30 Threads: Thread Synchronization
31 Threads: Thread Safety and Per-thread Storage
32 Threads: Thread Cancellation
33 Threads: Further Details
34 Process Groups, Sessions, and Job Control
35 Process Priorities and Scheduling
36 Process Resources
37 Daemons
38 Writing Secure Privileged Programs
39 Capabilities
40 Login Accounting
41 Fundamentals of Shared Libraries
42 Advanced Features of Shared Libraries
43 Interprocess Communication Overview
44 Pipes and FIFOs
45 Introduction to System V IPC
46 System V Message Queues
47 System V Semaphores
48 System V Shared Memory
49 Memory Mappings
50 Virtual Memory Operations
51 Introduction to POSIX IPC
52 POSIX Message Queues
53 POSIX Semaphores
54 POSIX Shared Memory
55 File Locking
56 Sockets: Introduction
57 Sockets: Unix Domain
58 Sockets: Fundamentals of TCP/IP Networks
59 Sockets: Internet Domains
60 Sockets: Server Design
61 Sockets: Advanced Topics
62 Terminals
63 Alternative I/O Models
64 Pseudoterminals
A Tracing System Calls
B Parsing Command-Line Options
C Casting the NULL Pointer
D Kernel Configuration
E Further Sources of Information
F Solutions to Selected Exercises
Bibliography
Index

对于Unix/Linux下的开发，《The Linux Programming Interface》可谓是面面俱到，实在是必备的一本书籍。当前《The Linux Programming Interface》在中国并没有引进，网络上也没有对完整的电子版可供下载，作者只是放出了本书的部分章节的PDF，不过从本书作者的个人网站上得到如下消息:

A number of people have asked about an ebook version of TLPI. There will be an ebook version.
Currently, the publisher plans to release the ebook in January 2011. In the meantime,
if you purchase the paper copy direct from No Starch Press,
they will provide you with a copy of the ebook when it becomes available.
(When the ebook becomes available, you will be able to purchase it independently of the print version.)

看来在2011年1月份，我们就可以下载到本书的完整电子版了，期待中

本站原创文章，转载请注明出处。