Phar::isValidPharFilename

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 1.2.0)

Phar::isValidPharFilename — Détermine si le nom de fichier spécifié est un nom de fichier valide pour une archive phar

Description

final public static Phar::isValidPharFilename(string $filename, bool $executable = true): bool

Détermine si le nom de fichier spécifié est une nom de fichier valide pour une archive phar, qui sera reconnue comme telle par l'extension phar. Ceci peut être utilisé pour tester un nom sans avoir à instancier une archive phar et à attraper l'inévitable Exception qui sera levée si un nom de fichier non valide est spécifié.

Liste de paramètres

filename: Le nom ou le chemin complet vers une archive phar non encore créée
executable: Ce paramètre détermine si le nom de fichier doit être traité comme celui d'une archive phar exécutable ou comme une archive de données non exécutable.

Valeurs de retour

Retourne true si le nom de fichier est valide, false sinon.

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 2 notes

down

kevin dot sours at internetbrands dot com ¶

4 months ago

This appears to return true for the running phar file regardless of the file extension.  This is undocumented (as is the fact that PHP will run phar files perfectly fine with a php extension).  This allows, for instance, reading the metadata for the running phar.

down

sebastian dot krebs dot berlin at googlemail dot com ¶

13 years ago

Note, that this method accepts _everything_ (=> returns 'true'), when $executable is 'false' as long as the filename contains at least a dot

var_dump(\PharData::isValidPharFilename('randomstring.y', false));
bool(true)

This is not wrong at all, because I can name an archive like I want, but it makes the method completely useless (when $executable == false).

＋add a note