【发布时间】:2018-02-26 19:27:19
【问题描述】:
我正在编写一些使用 cURL 的脚本,对是否需要显式设置各种选项或是否默认设置感兴趣,因此提出了http://php.net/manual/en/function.curl-setopt.php。通常手动会明确说明给定选项的默认值是 true 还是 false,虽然 curl_setopt() 对其中许多人这样做,但对其他人却不这样做。
该手册似乎通过以粗体输入来传达默认值,但由于我从未读过该手册使用此约定,因此我开始搜索它并惊讶地发现要么没有关于如何使用的说明使用手册或它们很难找到。
PHP 手册是否使用 bold 字体指示默认布尔值。是否有任何文档描述了本手册使用的这一约定和其他约定?
【问题讨论】:
-
通过使用大写粗体手册表示PHP常量。
-
doc.php.net/tutorial 告诉如何创建文档
-
@aynber 我本来希望在那里,特别是在doc.php.net/tutorial/style.php 或doc.php.net/tutorial/faq.php,但事实并非如此。我能找到的最接近的是常见问题解答中的
the <initializer> tag is used to signify the default value。 -
@u_mulder 我不认为粗体大写字体仅用于常量。手动使用 TRUE 和 FALSE,以及 TRUE 和 FALSE。
-
@user1032531 PHP 程序员应该能够识别这些内置名称,因此他们不应该被不一致的排版所迷惑。
标签: php conventions manual