phpdoc入门时遇到的问题
我在开始使用phpdoc时遇到问题。 我创建了一个示例php文件。代码如下:phpdoc入门时遇到的问题,php,phpdoc,Php,Phpdoc,我在开始使用phpdoc时遇到问题。 我创建了一个示例php文件。代码如下: <?php /** * short comment */ /** This is the * longer comment */ /** * @author My Name <my.name@example.com> */ echo "Hello, World"; ?> php文件就是我粘贴在这里的文件。C:\phpdoc\是应该放置文档的位置。现在,当我转到那里时,会生
<?php
/**
* short comment
*/
/** This is the
* longer comment
*/
/**
* @author My Name <my.name@example.com>
*/
echo "Hello, World";
?>
php文件就是我粘贴在这里的文件。C:\phpdoc\是应该放置文档的位置。现在,当我转到那里时,会生成几个文件和文件夹,但当我打开“index.php”文件并单击“Global()”时,我的窗口如下所示:
[我本来会在这里放一张图片,但我的声誉很低。我试图描述它的外观:它看起来像一个网页,css文件的路径无效。所有图片和自定义按钮都丢失了,字体只是普通的times new roman字体。没有背景图片等等]
为什么呢?我做错了什么
顺便说一句:我使用的是Windows7x64和新版本(也是新安装的)XAMPP
非常感谢您阅读我使用apigen编写了我的php docblocks,我想phpdoc也可以这样做。您要做的是将所有这些放在一个块中,如下所示:
/**
* Short description, keep to one line.
*
* Long description, you can break this up
* over multiple lines.
*
* @author your.name@yourplace.com
* @param incoming The variable that is being sent in
* @return bool Type of variable to return and explanation of return value
*/
public function doStuff($incoming) {
//Do stuff here
return true;
}
您可以将这些函数、变量和类放在上面。通常,为文件创建的第一个docblock将成为整个文件的docblock。Hi!谢谢你的回答!不幸的是,我已经尝试过了,但结果没有改变任何东西。@user2399808就docblock而言,这就是我用于apigen的内容。phpdoc可能会有所不同,但我不明白为什么他们会将块分解成更小的块。对于其他有关缺少映像之类的问题,Windows 7中的UAC可能会妨碍您,因为您正在写入硬盘的根目录,假设Windows安装的位置是C:。我要么将您的输出目录移动到其他地方(如C:\xampp\htdocs\libs\phpdoc),要么在管理模式下运行cmd,这样phpdoc就不会受到任何权限问题的影响。
/**
* Short description, keep to one line.
*
* Long description, you can break this up
* over multiple lines.
*
* @author your.name@yourplace.com
* @param incoming The variable that is being sent in
* @return bool Type of variable to return and explanation of return value
*/
public function doStuff($incoming) {
//Do stuff here
return true;
}