Tue l'exécution de WordPress et affiche une page HTML avec un message d'erreur.

Description

Cette fonction complète la fonction die() fonction PHP. La différence est que le HTML sera affiché à l'utilisateur. Il est recommandé d'utiliser cette fonction uniquement lorsque l'exécution ne doit pas continuer plus loin. Il n'est pas recommandé d'appeler cette fonction très souvent, et d'essayer de gérer autant d'erreurs que possible de manière silencieuse ou plus gracieuse.

En guise de raccourci, le code de réponse HTTP souhaité peut être transmis sous forme d'un nombre entier à la fonction $title (le titre par défaut s'appliquerait) ou au paramètre $args ou au paramètre $args .

Paramètres

$message

(chaîne de caractères|WP_Error)(Facultatif) Message d'erreur. S'il s'agit d'un objet WP_Error, et non d'une requête Ajax ou XML-RPC, les messages de l'erreur sont utilisés.

Valeur par défaut : ''

$title

(chaîne de caractères|int)(Facultatif) Titre de l'erreur. Si $message est un WP_Error les données d'erreur avec la clé 'title' peuvent être utilisées pour spécifier le titre. Si $title est un nombre entier, alors il est traité comme le code de réponse.

Valeur par défaut : ''

$args

(chaîne de caractères|tableau|int)(Facultatif)Arguments pour contrôler le comportement. Si $args est un nombre entier, alors il est traité comme le code de réponse.

  • "réponse
    (int) Le code de réponse HTTP. Par défaut 200 pour les requêtes Ajax, 500 sinon.
  • 'link_url'
    (chaîne de caractères) Une URL vers laquelle inclure un lien. Ne fonctionne qu'en combinaison avec $link_text. Chaîne vide par défaut.
  • 'link_text'
    (chaîne de caractères) Une étiquette pour le lien à inclure. Ne fonctionne qu'en combinaison avec $link_url. Chaîne vide par défaut.
  • 'back_link'
    (bool) S'il faut inclure un lien pour revenir en arrière. Par défaut, false.
  • 'text_direction'
    (chaîne de caractères) La direction du texte. Ceci n'est utile qu'en interne, lorsque WordPress est encore en train de se charger et que la locale du site n'est pas encore configurée. Accepte 'rtl' et 'ltr'. La valeur par défaut est la valeur de is_rtl().
  • 'jeu de caractères'.
    (chaîne de caractères) Jeu de caractères de la sortie HTML. Par défaut, 'utf-8'.
  • 'code'
    (chaîne de caractères) Code d'erreur à utiliser. La valeur par défaut est 'wp_die', ou le code d'erreur principal si $message est un WP_Error.
  • 'exit'
    (bool) Si l'on veut quitter le processus après son achèvement. Par défaut, true.

Valeur par défaut : array()

Plus d'informations

Vous pouvez ajouter un WP_Error objet. Si vous l'avez fait, vous pouvez ajouter un objet de type $data['title'] à l'objet error et il sera automatiquement pris comme titre (par défaut/supprimable) pour la page die.

Source

Fichier : wp-includes/functions.php

functionwp_die($message='',$title='',$args=array()){global$wp_query;if(is_int($args)){$args=array('response'=>$args);}elseif(is_int($title)){$args=array('response'=>$title);$title='';}if(wp_doing_ajax()){/**
		 * Filters the callback for killing WordPress execution for Ajax requests.
		 *
		 * @since 3.4.0
		 *
		 * @param callable $function Callback function name.
		 */$function=apply_filters('wp_die_ajax_handler','_ajax_wp_die_handler');}elseif(wp_is_json_request()){/**
		 * Filters the callback for killing WordPress execution for JSON requests.
		 *
		 * @since 5.1.0
		 *
		 * @param callable $function Callback function name.
		 */$function=apply_filters('wp_die_json_handler','_json_wp_die_handler');}elseif(wp_is_jsonp_request()){/**
		 * Filters the callback for killing WordPress execution for JSONP requests.
		 *
		 * @since 5.2.0
		 *
		 * @param callable $function Callback function name.
		 */$function=apply_filters('wp_die_jsonp_handler','_jsonp_wp_die_handler');}elseif(defined('XMLRPC_REQUEST')&&XMLRPC_REQUEST){/**
		 * Filters the callback for killing WordPress execution for XML-RPC requests.
		 *
		 * @since 3.4.0
		 *
		 * @param callable $function Callback function name.
		 */$function=apply_filters('wp_die_xmlrpc_handler','_xmlrpc_wp_die_handler');}elseif(wp_is_xml_request()||isset($wp_query)&&(function_exists('is_feed')&&is_feed()||function_exists('is_comment_feed')&&is_comment_feed()||function_exists('is_trackback')&&is_trackback())){/**
		 * Filters the callback for killing WordPress execution for XML requests.
		 *
		 * @since 5.2.0
		 *
		 * @param callable $function Callback function name.
		 */$function=apply_filters('wp_die_xml_handler','_xml_wp_die_handler');}else{/**
		 * Filters the callback for killing WordPress execution for all non-Ajax, non-JSON, non-XML requests.
		 *
		 * @since 3.0.0
		 *
		 * @param callable $function Callback function name.
		 */$function=apply_filters('wp_die_handler','_default_wp_die_handler');}call_user_func($function,$message,$title,$args);}

Related

Utilise

Utilisations Description
wp-includes/load.php : wp_is_jsonp_request()

Vérifie si la requête actuelle est une requête JSONP, ou si elle attend une réponse JSONP.

wp-includes/load.php : wp_is_xml_request()

Vérifie si la requête actuelle est une requête XML, ou si elle attend une réponse XML.

wp-includes/functions.php : wp_die_jsonp_handler

Filtre le callback permettant de tuer l'exécution de WordPress pour les requêtes JSONP.

wp-includes/functions.php : wp_die_xml_handler

Filtre le callback permettant de tuer l'exécution de WordPress pour les requêtes XML.

wp-includes/functions.php : wp_die_json_handler

Filtre le callback permettant de tuer l'exécution de WordPress pour les requêtes JSON.

wp-includes/load.php : wp_is_json_request()

Vérifie si la requête actuelle est une requête JSON, ou si elle attend une réponse JSON.

wp-includes/load.php : wp_doing_ajax()

Détermine si la requête en cours est une requête Ajax de WordPress.

wp-includes/query.php : is_trackback()

Détermine si la requête est destinée à un appel de point de terminaison trackback.

wp-includes/query.php : is_feed()

Détermine si la requête concerne un flux.

wp-includes/query.php : is_comment_feed()

La requête concerne-t-elle un flux de commentaires ?

wp-includes/functions.php : wp_die_ajax_handler

Filtre le callback permettant de tuer l'exécution de WordPress pour les requêtes Ajax.

wp-includes/functions.php : wp_die_xmlrpc_handler

Filtre le callback permettant de tuer l'exécution de WordPress pour les requêtes XML-RPC.

wp-includes/functions.php : wp_die_handler

Filtre le callback permettant de tuer l'exécution de WordPress pour toutes les requêtes non-Ajax, non-JSON, non-XML.

wp-includes/plugin.php : apply_filters()

Appelle les fonctions de rappel qui ont été ajoutées à un crochet de filtre.

Utilisé par

Utilisé par Description
wp-includes/sitemaps/class-wp-sitemaps-renderer.php : WP_Sitemaps_Renderer::check_for_simple_xml_availability()

Vérifie la disponibilité de l'extension SimpleXML et les erreurs en cas d'absence.

wp-includes/class-wp-recovery-mode.php : WP_Recovery_Mode::handle_exit_recovery_mode()

Traite une demande de sortie du mode de récupération.

wp-includes/class-wp-recovery-mode.php : WP_Recovery_Mode::handle_cookie()

Gère la vérification du cookie du mode de récupération et sa validation.

wp-includes/class-wp-recovery-mode-link-service.php : WP_Recovery_Mode_Link_Service::handle_begin_link()

Entre en mode de récupération lorsque l'utilisateur frappe wp-login.php avec un lien de mode de récupération valide.

wp-includes/class-wp-fatal-error-handler.php : WP_Fatal_Error_Handler::display_default_error_template()

Affiche le modèle d'erreur PHP par défaut.

wp-includes/class-wp-customize-manager.php : WP_Customize_Manager::handle_load_themes_request()

Charger les thèmes dans l'interface utilisateur de navigation/installation des thèmes.

wp-admin/press-this.php : wp_load_press_this()
wp-includes/comment.php : wp_check_comment_flood()

Vérifie si l'inondation des commentaires se produit.

wp-admin/includes/ajax-actions.php : wp_ajax_get_post_thumbnail_html()

Gestionnaire Ajax pour récupérer le HTML de l'image vedette.

wp-admin/includes/ajax-actions.php : wp_ajax_delete_inactive_widgets()

Gestionnaire Ajax pour la suppression des widgets inactifs.

wp-includes/class-wp-customize-nav-menus.php : WP_Customize_Nav_Menus::ajax_load_available_items()

Gestionnaire Ajax pour le chargement des éléments de menu disponibles.

wp-includes/class-wp-customize-nav-menus.php : WP_Customize_Nav_Menus::ajax_search_available_items()

Gestionnaire Ajax pour la recherche des éléments de menu disponibles.

wp-admin/includes/media.php : wp_media_attach_action()

Encapsule la logique des actions d'attachement/détachement.

wp-admin/includes/class-file-upload-upgrader.php : File_Upload_Upgrader::__construct()

Construit l'upgrader pour un formulaire.

wp-admin/includes/class-wp-screen.php : WP_Screen::get()

Récupère un objet écran.

wp-admin/includes/theme-install.php : install_theme_information()

Afficher les informations du thème dans le formulaire de la boîte de dialogue.

wp-admin/includes/ms.php : _access_denied_splash()

Affiche un message d'accès refusé lorsqu'un utilisateur tente de consulter le tableau de bord d'un site auquel il n'a pas accès.

wp-admin/includes/ms.php : check_upload_size()

Détermine si le fichier téléchargé dépasse le quota d'espace.

wp-admin/includes/class-wp-theme-install-list-table.php : WP_Theme_Install_List_Table::prepare_items()
wp-admin/includes/plugin-install.php : install_plugin_information()

Afficher les informations du plugin sous forme de boîte de dialogue.

wp-admin/includes/upgrade.php : wp_check_mysql_version()

Vérifie la version du binaire MySQL installé.

wp-admin/includes/user.php : edit_user()

Modifier les paramètres de l'utilisateur en fonction du contenu de $_POST.

wp-admin/includes/post.php : post_preview()

Sauvegarde un brouillon ou autosauvegarde manuelle dans le but d'afficher un aperçu du post.

wp-admin/includes/post.php : write_post()

Appelle wp_write_post() et gère les erreurs.

wp-admin/includes/post.php : edit_post()

Mise à jour d'un post existant avec les valeurs fournies dans $_POST.

wp-admin/includes/post.php : bulk_edit_posts()

Traite les données des posts pour l'édition en masse des posts.

wp-admin/includes/ajax-actions.php : wp_ajax_save_widget()

Gestionnaire Ajax pour l'enregistrement d'un widget.

wp-admin/includes/ajax-actions.php : wp_ajax_upload_attachment()

Gestionnaire Ajax pour le téléchargement de pièces jointes.

wp-admin/includes/ajax-actions.php : wp_ajax_image_editor()

Gestionnaire Ajax pour l'édition d'images.

wp-admin/includes/ajax-actions.php : wp_ajax_set_post_thumbnail()

Gestionnaire Ajax pour définir l'image vedette.

wp-admin/includes/ajax-actions.php : wp_ajax_date_format()

Gestionnaire Ajax pour le formatage de la date.

wp-admin/includes/ajax-actions.php : wp_ajax_time_format()

Gestionnaire Ajax pour le formatage de l'heure.

wp-admin/includes/ajax-actions.php : wp_ajax_wp_remove_post_lock()

Gestionnaire Ajax pour la suppression d'un post lock.

wp-admin/includes/ajax-actions.php : wp_ajax_dismiss_wp_pointer()

Gestionnaire Ajax pour le renvoi d'un pointeur WordPress.

wp-admin/includes/ajax-actions.php : wp_ajax_add_menu_item()

Gestionnaire Ajax pour l'ajout d'un élément de menu.

wp-admin/includes/ajax-actions.php : wp_ajax_add_meta()

Gestionnaire Ajax pour l'ajout de méta.

wp-admin/includes/ajax-actions.php : wp_ajax_add_user()

Gestionnaire Ajax pour l'ajout d'un utilisateur.

wp-admin/includes/ajax-actions.php : wp_ajax_closed_postboxes()

Gestionnaire Ajax pour les boîtes aux lettres fermées.

wp-admin/includes/ajax-actions.php : wp_ajax_hidden_columns()

Gestionnaire Ajax pour les colonnes cachées.

wp-admin/includes/ajax-actions.php : wp_ajax_update_welcome_panel()

Gestionnaire Ajax pour la mise à jour de l'affichage ou non du panneau de bienvenue.

wp-admin/includes/ajax-actions.php : wp_ajax_menu_get_metabox()

Gestionnaire Ajax pour la récupération des boîtes méta des menus.

wp-admin/includes/ajax-actions.php : wp_ajax_wp_link_ajax()

Gestionnaire Ajax pour les liens internes.

wp-admin/includes/ajax-actions.php : wp_ajax_menu_locations_save()

Gestionnaire Ajax pour la sauvegarde des emplacements de menu.

wp-admin/includes/ajax-actions.php : wp_ajax_meta_box_order()

Gestionnaire Ajax pour la sauvegarde de l'ordre des boîtes méta.

wp-admin/includes/ajax-actions.php : wp_ajax_menu_quick_search()

Gestionnaire Ajax pour la recherche rapide dans les menus.

wp-admin/includes/ajax-actions.php : wp_ajax_get_permalink()

Gestionnaire Ajax pour récupérer un permalien.

wp-admin/includes/ajax-actions.php : wp_ajax_sample_permalink()

Gestionnaire Ajax pour récupérer un exemple de permalien.

wp-admin/includes/ajax-actions.php : wp_ajax_inline_save()

Gestionnaire Ajax pour l'édition rapide enregistrant un article à partir d'un tableau de liste.

wp-admin/includes/ajax-actions.php : wp_ajax_inline_save_tax()

Gestionnaire Ajax pour l'enregistrement rapide des modifications pour un terme.

wp-admin/includes/ajax-actions.php : wp_ajax_widgets_order()

Gestionnaire Ajax pour la sauvegarde de l'ordre des widgets.

wp-admin/includes/ajax-actions.php : wp_ajax_dashboard_widgets()

Gestionnaire Ajax pour les widgets du tableau de bord.

wp-admin/includes/ajax-actions.php : wp_ajax_logged_in()

Gestionnaire Ajax pour l'état de connexion de l'aperçu du Customizer.

wp-admin/includes/ajax-actions.php : _wp_ajax_add_hierarchical_term()

Gestionnaire Ajax pour l'ajout d'un terme hiérarchique.

wp-admin/includes/ajax-actions.php : wp_ajax_delete_comment()

Gestionnaire Ajax pour la suppression d'un commentaire.

wp-admin/includes/ajax-actions.php : wp_ajax_delete_tag()

Gestionnaire Ajax pour la suppression d'une balise.

wp-admin/includes/ajax-actions.php : wp_ajax_delete_link()

Gestionnaire Ajax pour la suppression d'un lien.

wp-admin/includes/ajax-actions.php : wp_ajax_delete_meta()

Gestionnaire Ajax pour la suppression des méta.

wp-admin/includes/ajax-actions.php : wp_ajax_delete_post()

Gestionnaire Ajax pour la suppression d'un post.

wp-admin/includes/ajax-actions.php : wp_ajax_trash_post()

Gestionnaire Ajax pour l'envoi d'un post dans la corbeille.

wp-admin/includes/ajax-actions.php : wp_ajax_delete_page()

Gestionnaire Ajax pour supprimer une page.

wp-admin/includes/ajax-actions.php : wp_ajax_dim_comment()

Handler Ajax pour dimmer un commentaire.

wp-admin/includes/ajax-actions.php : wp_ajax_add_link_category()

Gestionnaire Ajax pour l'ajout d'une catégorie de liens.

wp-admin/includes/ajax-actions.php : wp_ajax_add_tag()

Gestionnaire Ajax pour ajouter une balise.

wp-admin/includes/ajax-actions.php : wp_ajax_get_tagcloud()

Gestionnaire Ajax pour obtenir un tagcloud.

wp-admin/includes/ajax-actions.php : wp_ajax_get_comments()

Gestionnaire Ajax pour obtenir des commentaires.

wp-admin/includes/ajax-actions.php : wp_ajax_replyto_comment()

Gestionnaire Ajax pour répondre à un commentaire.

wp-admin/includes/ajax-actions.php : wp_ajax_edit_comment()

Gestionnaire Ajax pour l'édition d'un commentaire.

wp-admin/includes/ajax-actions.php : wp_ajax_fetch_list()

Gestionnaire Ajax pour la récupération d'un tableau de listes.

wp-admin/includes/ajax-actions.php : wp_ajax_ajax_tag_search()

Gestionnaire Ajax pour la recherche de balises.

wp-admin/includes/ajax-actions.php : wp_ajax_wp_compression_test()

Gestionnaire Ajax pour les tests de compression.

wp-admin/includes/ajax-actions.php : wp_ajax_imgedit_preview()

Gestionnaire Ajax pour les aperçus de l'éditeur d'images.

wp-admin/includes/ajax-actions.php : wp_ajax_oembed_cache()

Gestionnaire Ajax pour la mise en cache oEmbed.

wp-admin/includes/ajax-actions.php : wp_ajax_autocomplete_user()

Gestionnaire Ajax pour l'autocomplétion des utilisateurs.

wp-admin/includes/bookmark.php : wp_link_manager_disabled_message()

Produit le message 'désactivé' pour le gestionnaire de liens de WordPress.

wp-admin/includes/bookmark.php : edit_link()

Met à jour ou insère un lien en utilisant les valeurs fournies dans $_POST.

wp-admin/includes/ms-deprecated.php : wpmu_checkAvailableSpace()

Détermine si l'espace disponible défini par l'admin a été dépassé par l'utilisateur.

wp-admin/includes/class-wp-terms-list-table.php : WP_Terms_List_Table::__construct()

Constructeur.

wp-admin/includes/file.php : validate_file_to_edit()

S'assure que le fichier dont on a demandé l'édition est autorisé à être édité.

wp-admin/includes/comment.php : edit_comment()

Mise à jour d'un commentaire avec les valeurs fournies dans $_POST.

wp-admin/includes/class-custom-image-header.php : Custom_Image_Header::step_2()

Afficher la deuxième étape de la page d'image d'en-tête personnalisée.

wp-admin/includes/class-custom-image-header.php : Custom_Image_Header::step_2_manage_upload()

Chargez le fichier à recadrer dans la deuxième étape.

wp-admin/includes/class-custom-image-header.php : Custom_Image_Header::step_3()

Affichage de la troisième étape de la page d'image d'en-tête personnalisée.

wp-admin/includes/class-custom-image-header.php : Page de l'image d'en-tête personnalisée ::admin_page()

Affiche la page en fonction de l'étape en cours.

wp-admin/includes/ms.php : confirm_delete_users()
wp-admin/includes/class-custom-background.php : Custom_Background::handle_upload()

Gère un téléchargement d'image pour l'image d'arrière-plan.

wp-includes/class-wp-customize-manager.php : WP_Customize_Manager::wp_die()

wrapper wp_die personnalisé. Renvoie soit le message standard pour l'interface utilisateur, soit le message Ajax.

wp-includes/class-wp-customize-manager.php : WP_Customize_Manager::setup_theme()

Démarrer la prévisualisation et la personnalisation du thème.

wp-includes/theme.php : switch_theme()

Commute le thème.

wp-includes/pluggable.php : wp_redirect()

Redirige vers une autre page.

wp-includes/pluggable.php : check_ajax_referer()

Vérifie la requête Ajax pour éviter de traiter des requêtes externes au blog.

wp-includes/class-wp.php : WP::parse_request()

Analyse la requête pour trouver la requête correcte de WordPress.

wp-includes/load.php : wp_check_php_mysql_versions()

Vérifie la version de PHP requise, et l'extension MySQL ou un drop-in de base de données.

wp-includes/load.php : wp_maintenance()

Meurt avec un message de maintenance lorsque les conditions sont remplies.

wp-includes/load.php : wp_set_wpdb_vars()

Définissez le préfixe de la table de base de données et les spécificateurs de format pour les colonnes de la table de base de données.

wp-includes/load.php : wp_not_installed()

Redirige vers l'installateur si WordPress n'est pas installé.

wp-includes/functions.php : wp_send_json()

Envoyer une réponse JSON en retour à une requête Ajax.

wp-includes/functions.php : dead_db()

Chargement d'une erreur de base de données personnalisée ou affichage d'une erreur de base de données WordPress.

wp-includes/functions.php : wp_nonce_ays()

Affichage du message "Are You Sure" pour confirmer l'action en cours.

wp-includes/functions.php : do_feed()

Charger le modèle de flux à partir de l'utilisation d'un crochet d'action.

wp-includes/class-wp-ajax-response.php : WP_Ajax_Response::send()

Afficher les réponses au format XML.

wp-includes/option.php : wp_protect_special_option()

Protège l'option spéciale de WordPress contre toute modification.

wp-includes/revision.php : _show_post_preview()

Filtre le dernier contenu pour la prévisualisation à partir de l'autosave du post.

wp-includes/ms-functions.php : maybe_add_existing_user_to_blog()

Ajouter un nouvel utilisateur à un blog en visitant /newbloguser/{key}/.

wp-includes/ms-load.php : ms_not_installed()

Affiche un message d'échec.

wp-includes/ms-load.php : ms_site_check()

Vérifie l'état du blog actuel.

wp-includes/ms-deprecated.php : wpmu_admin_do_redirect()

Redirige un utilisateur en fonction des arguments $_GET ou $_POST.

wp-includes/wp-db.php : wpdb::bail()

Enveloppe les erreurs dans un bel en-tête et un pied de page et meurt.

wp-includes/wp-db.php : wpdb::print_error()

Imprime une erreur SQL/DB.

wp-includes/class-wp-customize-widgets.php : WP_Customize_Widgets::wp_ajax_update_widget()

Met à jour les paramètres des widgets de manière asynchrone.

wp-includes/comment.php : wp_allow_comment()

Valide si ce commentaire est autorisé à être fait.

Changelog

Version Description
5.5.0 Le site $text_direction argument a une priorité sur get_language_attributes() dans le gestionnaire par défaut.
5.3.0 Le site $charset a été ajouté.
5.1.0 Le site $link_url, $link_text, et $exit ont été ajoutés.
4.1.0 Le site $title et $argsont été modifiés pour accepter facultativement un nombre entier à utiliser comme code de réponse.
2.0.4 Introduit.