Archive for 五月, 2009

21st
五月

phpDocumentor 三言两语
马克龙 发布于： 2009年05月21日 开发与应用 标签：, 评论 (0)


phpDocumentor

phpDocumentor为文档注释定义了一种结构，允许解析器以一种一致的方式解析它们。（：）一句话点点就可以了）

pear list 查看是否安装了phpDocumentor

安装 pear install phpDocumentor

phpdocumentor的使用分命令行模式和web模式，我只尝试了命令行模式：

phpdoc -h 该帮助命令会得到很详细的参数列表，其中：

  • -f 要进行分析的文件名，多个文件用英文逗号隔开
  • -d 要分析的目录，多个目录用英文逗号分割
  • -t 生成文档的存放路径
  • -o 输出的文档格式，结构为“输出格式：转换器名：模板目录”，包括HTML帧格式、Smarty模板格式、Windows帮助文件格式、PDF格式。
    例如：phpdoc -o HTML:Smarty:default -f test.php -t ./docs

PS：

  • 如果注释是中文的，一定要执行 iso-8859-1 到 utf-8 的替换，否则生成出来是乱码。
  • PHPDoc块必须以/**注释声明开始，才能成为被phpDoc识别的文档注释。
  • 标签是由@符号加上一个预定义的标识符表示的，完整的标签列表可参见http://manual.phpdoc.org/。
  • PHP代码在被实际执行之前会进行文法解析，即将PHP代码的文法结构转换成二进制格式的操作码（opcodes）。在这个过程中，文法解析器将忽略除文档注释外的所有注释，其注释内容不再出现在opcodes中。而文档注释会被实际解析，且注释内容会成为opcodes的一部分。

参考《PHPer》第19期

21st
五月

协作从良好的编码习惯开始
马克龙 发布于： 关于引钲创业, 开发与应用 标签： 评论 (0)

一个开发团队需要制定共同的编码标准吗？需要，而且是须要。以前没怎么觉得，直到我用一年时间经历过一个年轻开发团队的成长后，才发现它的重要性。

如果没有这个东西，如果没有共同的遵守，彼此配合起来是那么别扭，彼此没有专注在代码质量上，却花了很多时间在争吵代码风格上。私有属性不要下划线吧，老逼我用shift键？对象命名用大写吧，用小写很难看出它是个对象？你看看wordpress，你看看Discuz？……oh my god！

所以开发协作要从良好的编码习惯开始。良好的编码习惯指的是乐意遵守团队共同的编码标准，主要包括三个方面：
(全文…)

21st
五月

学会自省 – 《走出软件作坊》读后感
马克龙 发布于： 职场与职业思考 标签：, 评论 (0)

熬了几个夜晚，终于看完了《走出软件开发作坊》，尽管我非身处管理软件开发领域。

但如同管理软件开发领域一样，我们在web应用开发领域同样会遇到客户需求反复修改、开发过程的管理复杂多变、开发团队难以管理等诸多头疼的问题。你所在的团队，在面对这些问题时表现出来的态度、采用的解决办法，正好反映了这个团队的成熟度，也反映你的职业素养。阿朱毫无吝啬地与大家分享了自己多年的从业心得和实际经验，给IT中小企业好好地把了一下脉。对于个人，这本书带给我的最大收获是：学会自省。

“我是怎样一个人”，我们往往很难认清自己，甚至很难驾驭自己。我想认识自己的最好办法是，看看别人是怎样对待自己的。我们是怎样对待他人的，那么他人也一定是那样对待我们的。只有这样，我们个人才能在一个群体找到最适合自己的位置，才能被大家更加认可，才能为团队承担更多的责任。

如果你是团队的管理者，冷静思考一下，团队中其他人是怎样对待自己的：会倾听你的观点吗？会乐意接受你的任务吗？能真诚接受你的批评吗？会跟你商量事情吗？会向你提意见吗？……如果是，说明他们认同你的管理，信任你，相信与你一起能做出成绩；如果不是，说明自己管理一定有问题，思考自己是不是在言行上表现得太强势，是不是自己不够信任他们，是不是不尊重他们的建议，是不是在平衡团队利益上欠妥，是不是还停留在以前程序员的思维，是不是把简单的事情搞得复杂了，是不是拿着诸如《人月神话》、RUP、CMMI、UML等照本宣科？……想想别人为什么会那样对你，如果你是他们，又会怎样对待现在的“你”。

如果你不是个管理者，冷静思考一下，管理者是否愿意让你承担更多责任，其他团队成员是否乐意帮助你，他们是否愿意指正你的缺点，是否愿意和你推心置腹？……如果是，说明大家信任你，自己有能力也有责任为团队付出更多；如果不是，说明自己待人处事一定存在问题，想想自己在哪个环节做的不好，是不是不够信任大家，是不是付出太少而抱怨太多，是不是总记得嘀咕自己的功劳而忘记别人的苦劳，是不是自己说话前从不考虑后果，是不是自己从来不会推心置腹？……想想别人为什么会那样对你，如果你是他们，又会怎样对待现在的“你”。

“人，是人，真的是人”，阿朱的取词意味深长。只有我们把别人当成一个有血有肉有情有爱的人来对待，只有主动站在对方的立场来思考，我们个人的职业素养才能有进步，在做人做事上像阿朱、大宝那样驾轻就熟，团队才有希望。