logo
down
shadow

phpDocumentor: DocBlock with @var tags duplicates descriptions


phpDocumentor: DocBlock with @var tags duplicates descriptions

By : fidel amador
Date : November 22 2020, 02:59 PM
I wish did fix the issue. I have this DocBlock in a php abstract class: , I always document above the var itself. Maybe that's the issue
code :
/**
* @var string $foo a useful foo and <code>some.code()</code> too
*/
protected $foo;
/*
* @var string $bar a useless bar
*
* @todo do something with <code>$this->bar</code>
*/
protected $bar;


Share : facebook icon twitter icon
Is it possible to use phpDocumentor for parsing of DocBlock tags?

Is it possible to use phpDocumentor for parsing of DocBlock tags?


By : jinhuang50
Date : March 29 2020, 07:55 AM
should help you out I want to use phpDocumentor classes for parsing of my own PHP documentation and working with results. I can do this manually, but I'm pretty sure that phpDocumentor could be used. , I found out that Zend_Reflection_* classes can do this job.
PHPDoc: Is is possible to reference the object property descriptions from factory method docblock?

PHPDoc: Is is possible to reference the object property descriptions from factory method docblock?


By : Wing
Date : March 29 2020, 07:55 AM
this one helps. For the scenario you describe, the best path I can see is to have all those potential classes implement the same interface, or perhaps extend from the same abstract parent class. Then, use @return on the factory method to say it returns an object of that interface/abstract. That way, the IDE would be able to read the docblocks from the code of the interface/abstract and present info to you.
What is the point of redundant php docblock tags like @static?

What is the point of redundant php docblock tags like @static?


By : xaeloros the mighty
Date : March 29 2020, 07:55 AM
Hope this helps These tags were introduced for legacy PHP 4 code that didn't permit the use of such keywords in code. With PHP 5, the code is effectively self-documenting, so these tags are indeed redundant; I don't see any reason to keep them around.
In fact, if you ever generate documentation for your PHP 5 source files, phpDocumentor should still be able to determine that these are static methods. This is mentioned in the phpDocumentor docs:
phpDocumentor page-level docBlock in html included file

phpDocumentor page-level docBlock in html included file


By : Adam Szabo
Date : March 29 2020, 07:55 AM
it should still fix some issue Ok anwser found: https://github.com/phpDocumentor/phpDocumentor2/issues/695
TL;DR: At the moment, it's not fixed, just ignore theses warnings.
PHPDocumentor - what's wrong with my DocBlock?

PHPDocumentor - what's wrong with my DocBlock?


By : Shay L
Date : March 29 2020, 07:55 AM
wish help you to fix your issue I had the same issue with phpDocumentor version 2.8.1. It seems it's a bug in this version: enter link description here
I used version 2.7.0 and it's fine now.
Related Posts Related Posts :
  • Generating all 6 character alphanumeric combinations (upper and lower case)
  • PHP: Swap placeholders in string variable for corresponding defined variable values
  • HTTP request failed! with file get contents
  • How can I manipulate include_once string?
  • Database table not created after running plugin:refresh
  • Sphinx Get Word in Result through PHP API
  • Sending xml via soapclient in PHP
  • PHP class extension - skipping the middle class by calling the parent of the parent
  • Save data from contentEditable div with mysqli
  • Generating a PDF with sequential order images FPDF
  • How to make a request with PHPLeague oAuth2 client?
  • MySQL count rows with two duplicate column values
  • How to send a curl request with pem certificate via PHP?
  • Request error when processing form in controller
  • Can't save xml file content in mysql with fopen/fwrite/fclose (php)
  • Read only Title from a page?
  • PHP - make echo permanent and visible to all viewers
  • composer fails on server with redmine installed
  • Using foreach With Variables on Smarty
  • How do you specify single print blocks when looping through a 'for' loop?
  • PHP: $_FILES returns empty
  • Symfony2 associative array in entity
  • How do I log every output from a PHP script from the command line?
  • How to implement this json feed into a database structure?
  • Codeigniter, windows, xampp, how to use htaccess to get rid of trailing slash?
  • How to disable Navbar and footer in Yii2 other layouts
  • Json not encode my Special Character
  • echo if POST length is low
  • Warning: require_once error
  • What is this code meaning...?
  • Send to /dev/null a PHP function "echo" output
  • How to store post details and timestamp in database?
  • php mysql - search a row and concatenate values of every columns to variable string
  • Write a program to get N number of positive non-zero integers, so that the sum and product of these numbers are equal
  • Running two multi line queries in PHP
  • PHP/ASP Trouble understanding
  • Strict standards notices View/Layout class
  • how to have backwards reference on PHP's regex?
  • Uncaught exception 'RuntimeException' with message 'Unable to load ZF2. Run `php composer.phar install` or define a ZF2_
  • how to push an object to an array within an object with PHP
  • Undefined offset error in for loop
  • mysql query logic for fetching data from 3 related tables on certain condition
  • Saving blob video with php
  • SpeckPaypal ZF2 How to edit the CURRENCY CODE?
  • How to filter associated HABTM data with FriendsOfCake Search for CakePHP 3
  • Check ALL $_POST lengths
  • PHP - Recursively set each array element's key to the value of a child element when given the childs key name
  • How to disable the user from entering wrong passwords
  • SilverStripe Custom Email Form - jQuery.ajax not passing variables to server
  • Regular expression to extract Facebook URL's inc vanity
  • Show Calculated Field on SuiteCRM Dashlet
  • Class 'NumberFormatter' not found error in simple PHP program
  • Is it necessary to set values to a variable two times?
  • Scan Barcode - Save Code in SQL Database
  • Fetch MySQLi with custom database (aka, column names for array keys)
  • Symfony2 PagerFantaBundle
  • Wordpress: Restrict file uploads by MIME type
  • Find key in array in a foreach
  • pdo select query wont works with string of letters
  • Check if atleast one character is in mysql row, using php
  • shadow
    Privacy Policy - Terms - Contact Us © animezone.co