仓酷云

标题: PHP编程：PHPDocumentor 正文标准收拾 [打印本页]

作者: 深爱那片海 时间: 2015-1-16 22:11
标题: PHP编程：PHPDocumentor 正文标准收拾
熟悉HTML/CSS/JS等网页基本元素，完成阶段可自行制作完整的网页，对元素属性达到熟悉程度你会写正文么？从我写代码入手下手，这个成绩就一向困扰着我，信任也一样困扰着其他同砚。之前的写正文老是没有一套卓有成效的尺度，给保护和协同开辟带了很多贫苦，直到比来读到了phpdocumentor的正文尺度。

上面对phpdocumentor的正文尺度举行总结：

Type（数据范例）:

- string字符串范例
- integerorint整型
- booleanorbool布尔范例trueorfalse
- floatordouble浮点范例
- object工具
- mixed夹杂范例没有指定范例或不断定范例时利用
- array数组
- resource资本范例（如数据库查询前往）
- void空值（把持器前往值常常利用）
- nullnull范例
- callable回调函数
- falseortrue只前往trueorfasle时利用
- self本身
  Tags（标签）:
  
  Tag
  Element
  Description
  api
  Methods
  声明接口
  author
  Any
  作者信息
  category
  File,Class
  将一系列的元素分类在一同
  copyright
  Any
  版权信息
  deprecated
  Any
  声明元素已被弃用,能够在未来的版本中删除
  example
  Any
  示例
  filesource
  File
  文件资本
  global
  Variable
  声明一个选集变量
  ignore
  Any
  疏忽以后元素（phpdocumentor天生文档时）
  internal
  Any
  声明一个值为整形，大概设置一个使用的默许值为整型
  license
  File,Class
  声明允许范例
  link
  Any
  声明一个和以后元素有关的链接
  method
  Class
  声明以后类那些把戏办法能够被挪用
  package
  File,Class
  声明以后元素所属的包
  param
  Method,Function
  声明以后元素的一个参数
  property
  Class
  声明以后类有那些把戏办法能够被挪用属性
  property-read
  Class
  声明以后类有那些把戏办法能够读取属性
  property-write
  Class
  声明以后类有那些把戏办法能够设置属性
  return
  Method,Function
  前往值
  see
  Any
  申明以后元素参数援用于其他站点或元素
  since
  Any
  声明以后元素始于于哪一个版本
  source
  Any,exceptFile
  展现以后元素的源码
  subpackage
  File,Class
  将当期元素分类
  throws
  Method,Function
  申明以后元素抛出的非常
  todo
  Any
  申明以后元素的开辟举动
  uses
  Any
  援用一个联系关系元素
  var
  Properties
  声明属性
  version
  Any
  版本
  Example（示例）：
  //=============================
  
  @api
  1. /***Thismethodwillnotchangeuntilamajorrelease.**@api**@returnvoid*/functionshowVersion(){<...>}
  复制代码
  //=============================
  
  @author
  1. /***@authorMyName*@authorMyName*/
  复制代码
  //=============================
  
  @category
  1. /***Page-LevelDocBlock**@categoryMyCategory*@packageMyPackage*/
  复制代码
  //=============================
  
  @copyright
  1. /***@copyright1997-2005ThePHPGroup*/
  复制代码
  //=============================
  
  @deprecated
  1. /***@deprecated*@deprecated1.0.0*@deprecatedNolongerusedbyinternalcodeandnotrecommended.*@deprecated1.0.0Nolongerusedbyinternalcodeandnotrecommended.*/functioncount(){<...>}
  复制代码
  //=============================
  
  @example
  1. /***@exampleexample1.phpCountinginaction.*@examplehttp://example.com/example2.phpsCountinginactionbya3rdparty.*@exampleMyOwnExample.phpMycounting.*/functioncount(){<...>}
  复制代码
  //=============================
  @filesource
  1. /***@filesource*/
  复制代码
  //=============================
  @globalphpdocumentor2.0不撑持
  
  //=============================
  @ignore
  1. if($ostest){/***ThisdefinewilleitherbeUnixorWindows*/define(OS,Unix);}else{/***@ignore*/define(OS,Windows);}
  复制代码
  //=============================
  @internal
  1. /***@internal**@returnintegerIndicatesthenumberofitems.*/functioncount(){<...>}
  复制代码
  1. /***CountsthenumberofFoo.**{@internalSilentlyaddsoneextraFootocompensateforlackofFoo}}**@returnintegerIndicatesthenumberofitems.*/functioncount(){<...>}
  复制代码
  //=============================
  @license
  1. /***@authorMyName*@authorMyName*/0
  复制代码
  //=============================
  @link
  1. /***@authorMyName*@authorMyName*/1
  复制代码
  1. /***@authorMyName*@authorMyName*/2
  复制代码
  //=============================
  @method
  1. /***@authorMyName*@authorMyName*/3
  复制代码
  //=============================
  @package
  1. /***@authorMyName*@authorMyName*/4
  复制代码
  //=============================
  @param
  1. /***@authorMyName*@authorMyName*/5
  复制代码
  //=============================
  @property
  1. /***@authorMyName*@authorMyName*/6
  复制代码
  //=============================
  @property-read
  1. /***@authorMyName*@authorMyName*/7
  复制代码
  //=============================
  @property-write
  1. /***@authorMyName*@authorMyName*/8
  复制代码
  //=============================
  @return
  1. /***@authorMyName*@authorMyName*/9
  复制代码
  1. /***Page-LevelDocBlock**@categoryMyCategory*@packageMyPackage*/0
  复制代码
  //=============================
  @see
  1. /***Page-LevelDocBlock**@categoryMyCategory*@packageMyPackage*/1
  复制代码
  //=============================
  
  @since
  1. /***Page-LevelDocBlock**@categoryMyCategory*@packageMyPackage*/2
  复制代码
  1. /***Page-LevelDocBlock**@categoryMyCategory*@packageMyPackage*/3
  复制代码
  //=============================
  @source
  1. /***Page-LevelDocBlock**@categoryMyCategory*@packageMyPackage*/4
  复制代码
  //=============================
  @subpackage
  1. /***Page-LevelDocBlock**@categoryMyCategory*@packageMyPackage*/5
  复制代码
  //=============================
  @throws
  1. /***Page-LevelDocBlock**@categoryMyCategory*@packageMyPackage*/6
  复制代码
  //=============================
  @todo
  1. /***Page-LevelDocBlock**@categoryMyCategory*@packageMyPackage*/7
  复制代码
  //=============================
  @uses
  1. /***Page-LevelDocBlock**@categoryMyCategory*@packageMyPackage*/8
  复制代码
  //=============================
  @var
  1. /***Page-LevelDocBlock**@categoryMyCategory*@packageMyPackage*/9
  复制代码
  //=============================
  @version
  1. /***@copyright1997-2005ThePHPGroup*/0
  复制代码
  1. /***@copyright1997-2005ThePHPGroup*/1
  复制代码

你的确对PHP有兴趣，那么选择教材也是很重要的。

作者: 小女巫 时间: 2015-1-18 21:50
个人呢觉得，配wamp 最容易漏的一步就是忘了把$PHP$目录下的libmysql.dll拷贝到windows系统目录的system32目录下，还有重启apache。

作者: 山那边是海 时间: 2015-1-25 17:55
不禁又想起那些说php是草根语言的人，为什么认得差距这么大呢。

作者: 乐观 时间: 2015-2-3 12:32
Apache不是非得用80或者8080端口的，我刚开始安得时候就是80端口老占用，就用了个 81端口，结果照常，就是输localhost的时候，应该输入为 localhost:81

作者: 小妖女 时间: 2015-2-9 00:57
其实没啥难的，多练习，练习写程序，真正的实践比看100遍都有用。不过要熟悉引擎

作者: 第二个灵魂 时间: 2015-2-26 16:05
Apache不是非得用80或者8080端口的，我刚开始安得时候就是80端口老占用，就用了个 81端口，结果照常，就是输localhost的时候，应该输入为 localhost:81

作者: 飘飘悠悠 时间: 2015-3-8 16:07
再就是混迹于论坛啦，咱们的phpchina的论坛就很强大，提出的问题一般都是有达人去解答的，以前的帖子也要多看看也能学到不少前辈们的经验。别的不错的论坛例如php100，javaeye也是很不错的。

作者: 老尸 时间: 2015-3-16 04:06
其实没啥难的，多练习，练习写程序，真正的实践比看100遍都有用。不过要熟悉引擎

作者: 再现理想 时间: 2015-3-22 20:10
因为blog这样的可以让你接触更多要学的知识，可以接触用到类，模板，js ，ajax

作者: 深爱那片海 时间: 2015-3-22 20:10
其实也不算什么什么心得，在各位大侠算是小巫见大巫了吧，望大家不要见笑，若其中有错误的地方请各位大虾斧正。

作者: admin 时间: 2015-3-22 20:10
其实没啥难的，多练习，练习写程序，真正的实践比看100遍都有用。不过要熟悉引擎

欢迎光临仓酷云 (http://ckuyun.com/)