Discussion :

[berthos]

Bonjour,

J'essaie d'utiliser phpdoc pour la première fois.
J'ai placé le phar dans un répertoire que j'ai mis dans le path et j'ai créé le fichier cmd

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

@php "%~dp0phpDocumentor.phar" %*

.

Je l'ai testé sur mon site, cela ne fonctionne pas donc pour simplifier j'ai testé sur un seul fichier dont le contenu est :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
<?php
/**
 * This is a DocBlock.
 */
function associatedFunction()
{
}
?>

Mais j'ai toujours la même erreur.

Voici le message d'erreur :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
PHP Notice:  Trying to access array offset on value of type null in phar://D:/App/vendors/phpDocumentator/phpDocumentor.phar/vendor/doctrine/annotations/lib/Doctrine/Common/Annotations/DocParser.php on line 967
PHP Stack trace:
PHP   1. {main}() D:\App\vendors\phpDocumentator\phpDocumentor.phar:0
PHP   2. require() D:\App\vendors\phpDocumentator\phpDocumentor.phar:10
PHP   3. phpDocumentor\Bootstrap->initialize() phar://D:/App/vendors/phpDocumentator/phpDocumentor.phar/bin/phpdoc:22
PHP   4. phpDocumentor\Application->__construct() phar://D:/App/vendors/phpDocumentator/phpDocumentor.phar/src/phpDocumentor/Bootstrap.php:62
PHP   5. phpDocumentor\Application->addLogging() phar://D:/App/vendors/phpDocumentator/phpDocumentor.phar/src/phpDocumentor/Application.php:67
PHP   6. phpDocumentor\Application->offsetGet() phar://D:/App/vendors/phpDocumentator/phpDocumentor.phar/src/phpDocumentor/Application.php:254
PHP   7. Pimple::{closure:phar://D:/App/vendors/phpDocumentator/phpDocumentor.phar/vendor/pimple/pimple/lib/Pimple.php:122-130}() phar://D:/App/vendors/phpDocumentator/phpDocumentor.phar/vendor/pimple/pimple/lib/Pimple.php:83
PHP   8. phpDocumentor\Configuration\ServiceProvider->phpDocumentor\Configuration\{closure:phar://D:/App/vendors/phpDocumentator/phpDocumentor.phar/src/phpDocumentor/Configuration/ServiceProvider.php:79-83}() phar://D:/App/vendors/phpDocumentator/phpDocumentor.phar/vendor/pimple/pimple/lib/Pimple.php:126

Avez-vous une idée ?

[Freudd]

Bonjour berthos,

Les erreurs remontées par ta console sont étranges et elles ne nous indiquent pas clairement quel est le problème.
Donc autant chercher un aiguille dans une bote de foin XD

Voilà quelques pistes d'erreurs courantes pour tes rechercher :

• Si tu utilises PHPDoc 2.* il ne s'accorde pas avec PHP 7.
• ça peut-être la configuration de ton pnp.ini qui ne convient,
• ou ta configuration phpdoc.dist.xml qui ne fonctionne pas.

Conseil ultime, la doc est ton ami : https://www.phpdoc.org/

[berthos]

Bonjour

Il semble que ce soit un vieux truc qui ne fonctionne pas en PHP 7.

Est-ce que quelqu'un à un phpdocxxx qui fonctionne ?

[mjdev-it]

Bonjour,

Avec PHP7.4.1 sous ma version de Linux, cad Ubuntu 18.04, j'ai réussi à faire fonctionner phpdoc.

il y a une modification à faire dans le fichier :

(les traces écrans au lancement de phpdoc ont indiquées le fichier et les fonctions pour mon cas)

/usr/share/php/PhpDocumentor/phpDocumentor/Smarty-2.6.0/libs/Smarty_Compiler.class.php

il faut remplacer la ligne

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
 $source_content = preg_replace("!({$ldq})\*(.*?)\*({$rdq})!se",
                                        "'\\1*'.str_repeat(\"\n\", substr_count('\\2', \"\n\")) .'*\\3'",
                                        $source_content);

par ceci

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
$source_content = preg_replace_callback("!({$ldq})\*(.*?)\*({$rdq})!s", function ($matches) {
            return strtolower("'$matches[1]*'.str_repeat(\"\n\", substr_count('$matches[2]', \"\n\")) .'*$matches[3]'");
        }, $source_content);

en effet la fonction preg_replace n'existe plus dans les versions récentes de PHP

elle a été remplacé par la fonction preg_replace_callback

Depuis cette modif phpdoc fonctionne chez moi.

mjdev-it