Mon wiki - informatique:langages:php

array_pop_vs._array_shift

anonymous@undisclosed.example.com (Anonymous) — Thu, 02 Jan 2025 17:28:33 +0000

array_pop vs. array_shift

La fonction array_pop permet d'extraire le dernier élément d'un tableau tandis que array_shift permet d'extraire le premier élément d'un tableau. La finalité de ces fonctions est similaire mais il faut prêter attention aux performances car array_shift doit recalculer les index, ce qui n'est pas le cas de array_pop. Pour un tableau de petite taille, la différence est imperceptible mais quand sa taille augmente, cette différence se fait bien sentir. En effet, la complexité de array_pop est de O(1) tandis que celle de array_shift est de O(n).

Voici un exemple pour s'en convaincre :

benchmark.php

<?php
 
$shift = array_fill(0, 1000000, uniqid());
$pop = $shift;
 
echo 'array_shift processing: ';
$shiftStart = microtime(true);
while (null !== array_shift($shift)) {
}
echo (microtime(true) - $shiftStart), PHP_EOL, 'array_pop processing: ';
$popStart = microtime(true);
while (null !== array_pop($pop)) {
}
echo (microtime(true) - $popStart), PHP_EOL;

composer

anonymous@undisclosed.example.com (Anonymous) — Thu, 02 Jan 2025 17:28:33 +0000

Composer

C'est un gestionnaire de dépendance libre écrit en PHP. Il permet à ses utilisateurs de déclarer et d'installer les bibliothèques dont le projet principal a besoin.

Commandes utiles

Mise à jour de Composer

composer self-update
# Ou
composer selfupdate

Ajout d'un paquet dans la configuration

Cette commande va ajouter un paquet dans la configuration dans la section appropriée.

# Ajout d'un paquet pour l'ensemble des environnements.
composer require -- <paquet>
 
# Ajout d'un paquet pour l'environnement de développement.
composer require --dev -- <paquet>
 
# Ajout d'un paquet en spécifiant sa version.
# La version est gérée par les contraintes. Voir plus bas comment gérer les contraintes (lien externe).
composer require -- <paquet>:<contrainte>
# Pour utiliser une branche de développement
composer require -- <paquet>:dev-<branch>

Mise à jour des bibliothèques

Cette commande va mettre les bibliothèques à jour avec la dernière version disponible.

# Pour faire une mise à jour complète
composer update
 
# Pour faire une mise à jour partielle
composer update -- <paquet>

Lors de la mise à jour d'une bibliothèque ayant des dépendances bloquantes, il faut lister également les dépendances. Par exemple :

composer update -- friendsofsymfony/elastica-bundle ruflin/elastica

Installation des bibliothèques

Cette commande va créer le fichier composer.lock s'il n'existe pas. Si le fichier composer.lock existe, les bibliothèques seront mise à jour avec la version spécifiée dans le dit fichier.

# Pour faire une installation complète
composer install
 
# Pour faire une installation partielle
composer install -- <paquet>

Affichage des bibliothèques

Cette commande affiche les informations détaillées des bibliothèques disponibles.

# Affiche toutes les bibliothèques
composer show
 
# Affiche les bibliothèques installées
composer show -i
 
# Affiche les extensions installées
composer show -p

Installer un dépôt Composer local

Pour héberger et distribuer soi-même ses bibliothèques avec Composer, il est nécessaire de mettre en place un serveur. Satis permet de faire cela facilement.

Installer Satis

Rien de plus simple. Pour cela, il suffit d'utiliser Composer.

composer create-project composer/satis --stability=dev --keep-vcs

Cette commande va créer un répertoire satis qui contiendra le programme, la configuration du serveur ainsi que les bibliothèques.
Comme les bibliothèques seront distribuées par le serveur web, il est recommander d'exécuter la commande dans un répertoire accessible à l'utilisateur utilisé pour démarrer ce dernier.

Configurer Satis

La configuration se fait dans un fichier JSON à la racine du répertoire d'installation. Son nom n'a pas d'importance. Par défaut, satis.json sera utilisé.

Voici la configuration de base :

{
    "name": "Bibliothèque AINW",
    "homepage": "http://composer.ainw.org",
    "repositories": [
        { "type": "git", "url": "ssh://git.ainw.org/AinwBundle" }
    ],
    "require": {
        "ainw/ainw-bundle": "*"
    },
    "require-dependencies": false
}

name contient le nom du serveur qui sera affiché.
homepage est l'URL à utiliser dans la configuration de Composer.
repositories contient la liste des dépôts de bibliothèques.
require contient la liste des bibliothèques à distribuer, ainsi que leur version. L'utilisation de * permet de récupérer l'ensemble des versions disponibles.
require-dependencies indique si les dépendances doivent être hébergées.

Il est possible d'utiliser Satis pour héberger localement des bibliothèques distribuées. Pour cela, il faut modifier le fichier de configuration précédent :

{
    "name": "Bibliothèque AINW",
    "homepage": "http://composer.ainw.org",
    "repositories": [
        { "type": "git", "url": "ssh://git.ainw.org/AinwBundle" },
        { "type": "composer", "url": "https://packagist.org" }
    ],
    "require": {
        "ainw/ainw-bundle": "*",
        "phpunit/phpunit": "*",
    },
    "require-dependencies": true,
    "archive": {
        "directory": "archives"
    }
}

archive indique que les bibliothèques sont archivées. Il est possible de choisir le type d'archive, l'URL de distribution des archives ainsi que le répertoire de stockage (voir la documentation)

Générer le dépôt

Il suffit de lancer la commande suivante :

php bin/satis build <config.json> web/

Comme le dépôt est statique, il faut le générer régulièrement pour récupérer les dernières versions des bibliothèques hébergées.

Pour aller plus loin

Configurer Satis avec SSH et Git
Installer un dépôt local avec Satis. Contient le code pour mettre à jour la configuration automatiquement si une bibliothèque n'est pas encore présente.

Déclenchement d'actions externes

Lors de l'utilisation de la commande composer, il est possible de déclencher des actions extérieures en fonction de différents évènements. Il existe 4 types d'évènements ¹⁾:

les évènements sur la commande elle même.
les évènements sur l'installeur.
les évènements sur les packages.
les évènements sur les plugins.

Par exemple, on peut déclencher des actions après installation :

"scripts": {
    "post-install-cmd": [
        "ls -lh"
    ]
}

Dans ce cas, le script se déclenchera à la fin de chaque commande d'installation. Il est aussi possible de déclencher uniquement le script avec la commande suivante :

composer run-script post-install-cmd

Liens utiles

¹⁾

Nom des évènements

convertir_un_tableau_en_csv

anonymous@undisclosed.example.com (Anonymous) — Thu, 02 Jan 2025 17:28:33 +0000

Convertir un tableau en CSV

Il n'y a pas de fonction pour faire ça directement. Mais il est quand même possible de le faire en combinant certains outils de PHP.

// Ouverture d'un fichier mémoire en lecture/écriture ...
$fp = fopen('php://temp', 'r+');
// ... Écriture du tableau dans le fichier mémoire ...
$length += fputcsv($fp, $input, $delimiter, $enclosure);
// ... Retour au début du fichier mémoire que l'on vient d'écrire ...
rewind($fp);
// ... Lecture du fichier mémoire dans une variable ...
$data = fread($fp, $length);
// ... Fermeture du fichier mémoire ...
fclose($fp);

curiosites

anonymous@undisclosed.example.com (Anonymous) — Thu, 02 Jan 2025 17:28:33 +0000

Curiosités

Quine

<?php
readfile(__FILE__);

Boucle "for" sans paramètres

Cette boucle est une boucle infinie.

for (;;) {
    // ...
}

Elle est équivalente à cette autre boucle infinie :

while (true) {
    // ...
}

domdocument

anonymous@undisclosed.example.com (Anonymous) — Thu, 02 Jan 2025 17:28:33 +0000

todo

fonctions_meconnues

anonymous@undisclosed.example.com (Anonymous) — Thu, 02 Jan 2025 17:28:33 +0000

Fonctions méconnues

array_reduce réduit un tableau en une valeur unique.
checkdate indique si la date saisie est une date valide.
dirname retourne le répertoire parent. Le second paramètre indique le nombre de niveau à remonter. ¹⁾
escapeshellcmd corrige une chaîne de caractère destinée à être utilisée avec exec.
eval permet d'évaluer une chaîne de caractères comme du code PHP. ⚠ Il faut être conscient des problèmes de sécurités inhérents à cette fonction et de ne l'exécuter que sur une chaîne qui ne provient pas directement de l'utilisateur.
get_defined_vars affiche un tableau multi-dimension de l'ensemble des variables disponibles dans la portée de la fonction.
highlight_string affiche du code PHP colorisé dans une page.
http_build_query transforme un tableau associatif en une chaîne de paramètres à utiliser dans une URL.
levenshtein calcule la distance de Levenshtein entre deux chaînes de caractères.
pack compacte des données dans une chaîne binaire.
parse_url extrait les informations contenues dans une URL.
php_strip_whitespace enlève l'ensemble des commentaires et des espaces en trop d'un fichier source.
sscanf permet de d'extraire des variables d'une chaîne de caractères en fonction d'un motif de chaîne.
str_word_count compte le nombre de mots dans une chaîne de caractères.
unpack décompacte des données depuis une chaîne binaire.
wordwrap effectue la césure d'une chaîne de caractèrs.

¹⁾

exakat, static analysis for PHP (@exakat): "#phptip #phptrick Avoid long list of /../../../ by leveraging… / Twitter - Le Hollandais Volant

// Remplacer
dirname(__DIR__).'../../../a/b/c';
 
// Par
dirname(__DIR__, 3).'/a/b/c';

pcre_et_utf-8

anonymous@undisclosed.example.com (Anonymous) — Thu, 02 Jan 2025 17:28:33 +0000

PCRE et UTF-8

Il est possible de gérer des chaînes de caractères UTF-8 sans avoir besoin de recompiler PHP en activant le drapeau PCRE UTF-8. Pour faire cela, il suffit d'utiliser les options natives de la bibliothèque PCRE.

En ajoutant le motif (*UTF8) à l'expression rationnelle, preg_match sera capable de trouver le caractère é.

Pour plus d'information, voir les commentaires de la fonction preg_match.

php

anonymous@undisclosed.example.com (Anonymous) — Thu, 02 Jan 2025 17:28:33 +0000

todo

PHP

Liste pour la compréhension des opérateurs parce que c'est impossible de les rechercher dans un moteur, par exemple ….

ressources

anonymous@undisclosed.example.com (Anonymous) — Thu, 02 Jan 2025 17:28:33 +0000

Ressources

Pour écrire un parser

symfony2

anonymous@undisclosed.example.com (Anonymous) — Thu, 02 Jan 2025 17:28:33 +0000

Symfony 2

C'est un ensemble de composants PHP ainsi qu'un framework MVC libre écrit en PHP. Il fournit des fonctionnalités modulables et adaptables qui permettent de faciliter et d’accélérer le développement d'un site web.

Utilisation des paramètres de configuration dans un controleur

Il est possible d'ajouter des paramètres de configuration et de les utiliser dans un controleur.
La première chose à faire est de créer les paramètres dans le(s) fichier(s) de configuration de la manière suivante :

parameters:
  my_config: my_value

Attention, les paramètres ne supportent pas la syntaxe sur plusieurs niveaux des fichiers de traduction.

Ensuite, dans le controleur, il suffit de récupérer la valeur du paramètre stockée dans le container:

$this->container->getParameter('my_config')

Utilisation des paramètres de configuration dans une vue

Il est possible d'ajouter des paramètres de configuration et de les utiliser dans une vue.
La première chose à faire est de créer les paramètres dans le(s) fichier(s) de configuration de la manière suivante :

parameters:
  my_config: my_value

Attention, les paramètres ne supportent pas la syntaxe sur plusieurs niveaux des fichiers de traduction.

Ensuite, il faut créer des variables globales pour la vue (twig) dans le(s) fichier(s) de configuration de la manière suivante :

twig:
  globals:
    my_config: my_value

Notez que dans cette section, les paramètres supportent la syntaxe sur plusieurs niveaux.

Finalement, dans la vue, il suffit de récupérer la valeur de la variable globale :

{{ my_config }}

Pour plus d'information, voir la documentation.

Récupérer l'environnement depuis le container

$container->getParameter('kernel.environment');

twig

anonymous@undisclosed.example.com (Anonymous) — Thu, 02 Jan 2025 17:28:33 +0000

TWIG

C'est un moteur de templates pour le langage de programmation PHP, utilisé par défaut par le framework Symfony.

Traduction

traduction d'une variable

{{ ma_variable | trans }}

traduction d'une chaîne de caractères

{% trans %}ma_chaine{% endtrans %}

traduction d'une chaîne de caractères contenant une variable

{% trans with {'variable': ma_variable} %}ma_chaine variable{% endtrans %}

Attention, la variable est transmise à la chaîne traduite et ne sera donc pas elle même traduite.

traduction d'une chaîne de caractères variable

{# Méthode en passant par une variable #}
{% set ma_nouvelle_variable = "ma_chaine" ~ ma_variable %}
{{ ma_nouvelle_variable | trans }}
{# Méthode directe #}
{{ ("ma_chaine" ~ ma_variable) | trans }}

Attention, dans ce cas le contenu de la variable sera ajouté à la chaîne de caractères. C'est cette nouvelle chaîne de caractères qui sera traduite.

Contrôle des espaces

Le contrôle des espaces permet de modifier le code généré en supprimant les espaces (espaces, tabulations, etc.) du code HTML généré. Il existe plusieurs syntaxes pour réaliser cela.

suppression des espaces d'un bloc

{% spaceless %}
    <div>
        <strong>foo bar</strong>
    </div>
{% endspaceless %}

suppression des espaces d'une balise TWIG

{% set value = 'no spaces' %}
{#- No leading/trailing whitespace -#}
{%- if true -%}
    {{- value -}}
{%- endif -%}
{# output 'no spaces' #}

Fonctions utiles

affichage des informations d'une variable

{{ dump(ma_variable) }}

Liens utiles

utiliser_la_ligne_de_commande

anonymous@undisclosed.example.com (Anonymous) — Thu, 02 Jan 2025 17:28:33 +0000

Utiliser la ligne de commande

# Afficher la version
php -v
 
# Afficher la configuration
php -i
 
# Afficher les modules compilés
php -m
 
# Afficher les fichiers de configuration utilisés
php --ini
 
# Vérifier la syntaxe d'un fichier
php -l <fichier>
 
# Lancer PHP en mode interactif
php -a

utiliser_le_client_soap_avec_un_certificat

anonymous@undisclosed.example.com (Anonymous) — Thu, 02 Jan 2025 17:28:33 +0000

Utiliser le client SOAP avec un certificat

Certains services web demandent de s'authentifier avec un certificat.

En lisant la documentation, on se rend compte que le client SOAP accepte des options pour définir le certificat du client ainsi que son mot de passe. Malheureusement, je n'ai pas réussi à le faire fonctionner de cette manière.
Heureusement, il existe une autre façon de faire en injectant le certificat du client ainsi que son mot de passe directement dans la requête SSL.

$wsdl = "<URL du fichier de description du service web>";
 
// Ici on configure les options de la requête SSL
$context = stream_context_create([
    'ssl' => [
        'local_cert' => "<chemin d'accès au certificat>", // uniquement au format PEM
        'passphrase' => "<mot de passe du certificat>",
    ],
]);
 
// Ici on configure les options du client SOAP
$soap_options = [
    'stream_context' => $context, // injection des options de la requête SSL
];
 
// Ici on cré le client SOAP avec les options SOAP et SSL
$soap_client = new \SoapClient($wsdl, $soap_options);