Jony's Blog

PHP 编程最好能做好各种注释，不管是用 IDE 还是编辑器进行代码编写，良好的注释总能给予极大的帮助。对于 phpDoc 注释的用法这里做点简单的说明。

/**
* @name  名字
* @abstract  申明变量/类/方法
* @access  指明这个变量、类、函数/方法的存取权限
* @author  函数作者的名字和邮箱地址
* @category  组织packages
* @copyright  指明版权信息
* @const  指明常量
* @deprecate  指明不推荐或者是废弃的信息
* @example  示例
* @exclude  指明当前的注释将不进行分析，不出现在文挡中
* @final  指明这是一个最终的类、方法、属性，禁止派生、修改。
* @global  指明在此函数中引用的全局变量
* @include  指明包含的文件的信息
* @link  定义在线连接
* @module  定义归属的模块信息
* @modulegroup  定义归属的模块组
* @package  定义归属的包的信息
* @param  定义函数或者方法的参数信息
* @return  定义函数或者方法的返回信息
* @see  定义需要参考的函数、变量，并加入相应的超级连接。
* @since  指明该api函数或者方法是从哪个版本开始引入的
* @static  指明变量、类、函数是静态的。
* @throws  指明此函数可能抛出的错误异常,极其发生的情况
* @todo  指明应该改进或没有实现的地方
* @var  定义说明变量/属性。
* @version  定义版本信息
*/

最后更新：2009.9.19 语言包词条更新到 6.2.5 版

为了挑一个用得顺手的 PHP IDE 已经换用了不少个程序。其中包括 Zend Studio for Eclipse， NetBeans， EclipsePHP Studio 2008，phpED，phpCoder，phpDesigner 等等，最终还是觉得 phpDesigner 用起来很顺手，也许是以前用习惯了 Dreamweaver 做 HTML 方面的代码书写，所以很喜欢 phpDesigner 里的主动代码提示。在运行速度，资源占用，项目管理等方面 phpDesigner 也做得比较出色，可以说功能还是比较全面的，代码调试方面虽然不是非常强大，但也够用了。呵呵……

phpDesigner 默认已经自带了中文语言文件，安装并启动后在菜单里选择“查看”>“语言”就可以将界面更换成简体中文。这个语言文件是 php100.com 翻译制作的，不过使用一段后有了一个疑问，这个语言文件似乎机器翻译的可能性很大，最多有后期人工校对但非常的不完备，到处都是语法错误甚至翻译错误，看到软件菜单里有邀请使用者对软件进行翻译的链接，点进去后了解了一下程序的翻译方法，于是动了自己重新翻译一遍的想法。整整花了周末两天时间将程序汉化并初步校对完毕，自认为这个汉化还是比较成功的，期间不少专有名词花了些时间在网上搜索准确含义，呵呵。语言文件里重复的条目非常多，还好翻译工具挺聪明的，只需要将重复的条目里翻译一条，其他的会在下次重新打开翻译文本时自动匹配翻译掉剩余的重复条目。

好啦，用了一会暂时没发现什么错误，就共享出来吧，点击下载解压后覆盖掉 phpDesigner 安装目录里 Languages 文件夹中的 zh-cn.lng 文件即可，如果有发现翻译错误的地方欢迎大家指出来。

后记：刚发现只是 phpDesigner 里自带的简体中文语言包错误极多，php100.com 那下载的语言包要好很多，只是有少量翻译错误以及因为版本稍旧有一些 6.2.3 版本新增加的内容未翻译。