# Warning « Attempt to read property on null » sur wc_get_product : diagnostic

> Un produit supprimé sans nettoyage des références qui pointent encore vers lui : c'est la cause la plus fréquente de ce warning PHP récurrent sur wc_get_product.

- Auteur : Clément Hadrot
- Publié le : 2025-11-17
- Mis à jour le : 2025-11-17
- Catégorie : E-commerce
- URL : https://wpmoderne.dev.wordpress-developpement.fr/ecommerce/warning-property-null-wc-get-product-diagnostic/

## L’essentiel

- wc_get_product renvoie false, pas une exception, quand le produit n'existe plus
- Le vrai problème est en amont : des références orphelines jamais nettoyées
- La purge se fait sur les tables de commandes et de listes de souhaits

Un produit référencé disparaît sans que rien n'ait nettoyé les endroits où son identifiant continue d'être utilisé : c'est le scénario derrière la quasi-totalité des avertissements `Attempt to read property "name" on null` qui apparaissent dans les journaux d'une boutique WooCommerce en fonctionnement depuis plusieurs années. La fonction responsable, `wc_get_product()`, ne lève jamais d'exception quand l'identifiant demandé ne correspond à aucun produit existant : elle renvoie simplement `false`.

Le bug n'est donc jamais dans `wc_get_product()` elle-même, mais dans le code appelant qui suppose, à tort, qu'un objet produit valide est systématiquement renvoyé, et qui tente d'appeler une méthode ou de lire une propriété directement sur ce `false`.

## Où ce motif se cache le plus souvent

- Des listes de souhaits ou de favoris qui stockent des identifiants de produit dans une table personnalisée ou une métadonnée utilisateur, jamais purgée à la suppression d'un produit.
- Des lignes de commande anciennes (`WC_Order_Item_Product`) dont le produit lié a été supprimé après la commande, un cas parfaitement normal en soi.
- Des scripts d'export ou de synchronisation ERP qui itèrent sur une liste d'identifiants figée, sans revérifier leur existence au moment du traitement.

## Sécuriser chaque appel : le correctif immédiat

Le correctif de premier niveau consiste à toujours vérifier le retour de `wc_get_product()` avant de l'utiliser, ce qui élimine le warning immédiatement, sans modifier le comportement métier attendu :

```
$produit = wc_get_product( $product_id );

if ( ! $produit instanceof WC_Product ) {
    // Le produit n'existe plus : traiter le cas explicitement
    continue;
}

echo esc_html( $produit->get_name() );
```

Cette vérification devrait être systématique dans tout code personnalisé manipulant des identifiants de produit issus d'une source externe à la requête courante (métadonnée, table personnalisée, paramètre d'URL).

> L'essentiel à retenir : wc_get_product renvoie false, pas une exception, quand le produit n'existe plus ; Le vrai problème est en amont : des références orphelines jamais nettoyées ; La purge se fait sur les tables de commandes et de listes de souhaits

## Le vrai problème : des références orphelines qui s'accumulent

Sécuriser l'appel évite le warning, mais ne résout pas la cause : des identifiants de produits supprimés continuent de s'accumuler dans des listes de souhaits, des historiques de navigation, ou des tables de recommandations personnalisées. Sans nettoyage périodique, ces références orphelines grossissent indéfiniment et ralentissent les requêtes qui les parcourent, en plus de générer le warning à chaque affichage.

### Purger via le hook de suppression de produit

```
add_action( 'before_delete_post', function ( $post_id ) {
    if ( get_post_type( $post_id ) !== 'product' ) {
        return;
    }
    global $wpdb;
    $wpdb->delete( $wpdb->prefix . 'boutique_favoris', array( 'product_id' => $post_id ) );
} );
```

Brancher la purge directement sur la suppression, via `before_delete_post` ou `woocommerce_before_delete_product` selon le contexte, évite d'avoir à exécuter des scripts de nettoyage périodiques a posteriori.

## Cas des lignes de commande : ne jamais purger

Attention à ne pas appliquer la même logique de purge aux lignes de commandes existantes : un produit supprimé après avoir été vendu doit rester référencé dans l'historique de commande, pour des raisons comptables et de service client. Le correctif ici est uniquement défensif (vérifier avant d'afficher), jamais une suppression de la référence historique.

> Sur nos projets, la règle est simple : on sécurise systématiquement l'affichage d'un produit potentiellement supprimé, mais on ne purge que les usages « vivants » — favoris, recommandations, paniers sauvegardés — jamais l'historique des commandes passées.

## Détecter l'ampleur du problème avant de corriger au cas par cas

Avant de corriger chaque appel un par un, un script ponctuel permet de mesurer l'ampleur réelle du problème sur une boutique donnée, en comparant les identifiants référencés dans les tables personnalisées avec les identifiants de produits encore existants dans `wp_posts`.

## En résumé

Le warning `Attempt to read property on null` sur `wc_get_product()` est un symptôme, pas la maladie : la maladie, ce sont des références orphelines jamais nettoyées après la suppression d'un produit. Sécuriser chaque appel élimine le message ; brancher une purge sur la suppression du produit élimine la cause.