Quand devriez-vous utiliser WP_Query vs query_posts () vs get_posts ()?

• query_posts() esttrop simplisteet manièreproblématique demodifier la requêteprincipale d'unepageen la remplaçantpar unenouvelleinstance de la requête. Ilestinefficace (réexécute les requêtes SQL)et échouera carrément dans certaines circonstances (surtout souvent lors de lapagination des articles). Tout code WPmoderne doit utiliser desméthodesplusfiables,comme utiliser le pre_get_posts hook,à ceteffet. TL; DR n'utilisezjamais query_posts () .

• get_posts() esttrès similaire dans son utilisationet accepte lesmêmes arguments (avec quelquesnuances,comme des valeurspar défaut différentes),mais renvoie untableau d'articles,ne modifiepas les variablesglobaleset peut être utilisén'importe où.

• WP_Query est la classe qui alimente les deux les scènes,mais vouspouvez également créeret travailler avec votrepropreinstance. Unpeuplus complexe,moins de restrictions,aussi sûr à utilisern'importe où.

• query_posts() is overly simplistic and a problematic way to modify the main query of a page by replacing it with new instance of the query. It is inefficient (re-runs SQL queries) and will outright fail in some circumstances (especially often when dealing with posts pagination). Any modern WP code should use more reliable methods, like making use of the pre_get_posts hook, for this purpose. TL;DR don't use query_posts() ever.

• get_posts() is very similar in usage and accepts the same arguments (with some nuances, like different defaults), but returns an array of posts, doesn't modify global variables and is safe to use anywhere.

• WP_Query is the class that powers both behind the scenes, but you can also create and work with your own instance of it. A bit more complex, fewer restrictions, also safe to use anywhere.

query_posts - Vousne devriezjamais utiliser query_posts . En dehors de ce que @Rarst a dit,letrèsgrosproblème avec query_posts est qu'il casse l'objet de requêteprincipal (stocké dans $ wp_query ). Denombreuxpluginset codepersonnalisé reposent sur l'objet de requêteprincipal,donc casser l'objet de requêteprincipal signifie que vous rompez lesfonctionnalités despluginset du codepersonnalisé. Une seule de cesfonctionsest lafonction depagination laplusimportante,donc si vousinterrompez la requêteprincipale,vousinterrompez lapagination.

Pourprouver à quelpoint query_posts estmauvais,surn'importe quelmodèle,procédez comme suitet comparez les résultats

  var_dump ($ wp_query);
query_posts ('& amp;posts_per_page=-1');
var_dump ($ wp_query);
 

get_posts et WP_Query sont lebonmoyen de créer des requêtes secondaires (telles que des articles associés,des curseurs,du contenuen vedette et le contenu sur lespremièrespages statiques ) avec. Il convient denoter que vousne devez utiliser aucun des deuxen faveur de la requêteprincipale sur lapage d'accueil,lapage unique outouttype depage d'archive car celainterrompra lafonctionnalité de lapage. Si vous avezbesoin demodifier la requêteprincipale,utilisez pre_get_posts pour lefaire,et non une requêtepersonnalisée. ( UPDATE: Pour lespages degarde statiqueset les vraiespages,voir Utilisation depre_get_posts sur les vraiespageset lespremièrespages statiques *)

En substance, WP_Query est utilisépar la requêteprincipaleet est également utilisépar get_posts ,maisbien que get_posts () utilise WP_Query ,il y a quelques différences

• get_posts sontplus rapides que WP_Query . Lamarge dépend dumontanttotal despublications du site. La raisonen est que get_posts passe 'no_found_rows'=>true par défaut à WP_Query qui saute/rompt légalement lapagination. Avec 'no_found_rows'=>true , WP_Query obtient lenombre demessagesinterrogés,puis renverse,oùpar défaut,il rechercheplusen détailtous lesmessages correspondant à la requête afin de calculer lapagination.

  Pour cette raison,get_posts () ne doit être utilisé quepour les requêtesnonpaginées. Paginer get_posts est vraiment ungrosgâchis. WP_Query doit être utilisépourtoutes les requêtespaginées

• get_posts () ne sontpasinfluencéspar lesfiltres posts_ * où WP_Query estinfluencépar cesfiltres. La raisonen est que get_posts ,par défaut,transmet 'suppress_filters'=>true à WP_Query

• get_posts a quelquesparamètres supplémentaires comme include ,exclude ,numberposts et catégorie . Cesparamètres sontmodifiésen paramètres validespour WP_Query avant d'êtretransmis à WP_Query . include est changéen post__in ,exclude en post__not_in , category en cat et numberposts dans posts_per_page . Juste unenote,tous lesparamètres quipeuvent êtretransmis à WP_Query fonctionnent avec get_posts ,vous pouvez ignoreret nepas utiliser lesparamètrespar défaut de get_posts

• get_posts renvoie uniquement lapropriété $posts de WP_Query tandis que WP_Query renvoie l'objet complet. Cet objetesttrès utileen ce qui concerne les conditions,lapaginationet d'autresinformations utilespouvant être utilisées dans laboucle.

• get_posts n'utilisepas laboucle,mais uneboucle foreach pour afficher lesmessages. Deplus,aucunebalise demodèlen'est disponiblepar défaut. setup_postdata ($post) doit être utilisépour rendre lesbalises demodèle disponibles. WP_Query utilise laboucleet lesbalises demodèle sont disponiblespar défaut

• get_posts passe 'ignore_sticky_posts'=> 1 à WP_Query ,donc get_posts ignorepar défaut lesmessagespersistants

Sur labase de ce quiprécède,l'utilisation de get_posts ou WP_Query dépend de vouset de ce dont vous avez réellementbesoin dans la requête. Ce quiprécède devrait vousguider dans votre choix

query_posts - You should never ever use query_posts. Apart from what @Rarst has said, the really big issue with query_posts is, it breaks the main query object ( stored in $wp_query ). A lot of plugins and custom code relies on the main query object, so breaking the main query object means that you are breaking the functionalities of plugins and custom code. Just one such function is the all important pagination function, so if you break the main query, you break pagination.

To prove how bad query_posts is, on any template, do the following and compare the results

var_dump( $wp_query );
query_posts( '&posts_per_page=-1' );
var_dump( $wp_query );

get_posts and WP_Query are the correct way to construct secondary queries ( like related posts, sliders, featured content and content on static front pages ) with. It should be noted, you should not use any of the two in favor of the main query on the home page, single page or any type of archive page as it will break page functionality. If you need to modify the main query, use pre_get_posts to do so, and not a custom query. (UPDATE: For static front pages and true pages, see Using pre_get_posts on true pages and static front pages*)

In essence, WP_Query is used by the main query and is also used by get_posts, but although get_posts() uses WP_Query, there are a few differences

• get_posts are faster than WP_Query. The margin depends on the amount of total posts of the site. The reason for this is, get_posts passes 'no_found_rows' => true by default to WP_Query which skips/legally breaks pagination. With 'no_found_rows' => true, WP_Query gets the amount of posts queried, then bails out, where by default, it further search for all posts matching the query in order to calculate pagination.

  For this reason, get_posts() should be used for non paginated queries only. Paginating get_posts is really one big mess. WP_Query should be used for all paginated queries

• get_posts() aren't influenced by the posts_* filters where WP_Query gets influenced by these filters. The reason is that get_posts, by default, passes 'suppress_filters' => true to WP_Query

• get_posts has a couple of extra parameters like include, exclude, numberposts and category. These parameters do get changed into valid parameters for WP_Query before being passed to WP_Query. include gets changed into post__in, exclude into post__not_in, category into cat and numberposts into posts_per_page. Just a note, all of the parameters that can be passed to WP_Query works with get_posts, you can ignore and not use the default parameters of get_posts

• get_posts returns just the $posts property of WP_Query while WP_Query returns the complete object. This object is quite useful when it comes to conditionals, pagination and other useful info that can be used inside the loop.

• get_posts doesn't use the loop, but a foreach loop to display posts. Also, no template tags are available by default. setup_postdata( $post ) has to be used to make the template tags available. WP_Query uses the loop and template tags are available by default

• get_posts passes 'ignore_sticky_posts' => 1 to WP_Query, so get_posts by default ignores sticky posts

Based on the above, whether to use get_posts or WP_Query is up to you and what do you actually need from the query. The above should guide you in your choice

La différencefondamentaleest que query_posts()ne serten réalité qu'àmodifier laboucle actuelle.Unefois que vous avezterminé,ilestnécessaire de réinitialiser laboucleet de l'envoyer sur sonjoyeux chemin.Cetteméthodeest également unpeuplusfacile à comprendre,simplementparce que votre "requête"estessentiellement une chaîne d'URL que vouspassez à lafonction,comme ceci:

 query_posts('meta_key=color&meta_value=blue'); 
 

D'un autre côté,WP_Queryestplus un outil à usagegénéral,et ressembleplus à l'écriture directe de requêtes MySQL que query_posts().Vouspouvez également l'utilisern'importe où (pas seulement dans laboucle)et iln'interfèrepas avec les requêtes depublicationen cours.

J'aitendance à utiliser WP_Queryplus souvent,car cela arrive.Vraiment,cela dépendra de votre cas spécifique.

The basic difference is that query_posts() is really only for modifying the current Loop. Once you're done it's necessary to reset the loop and send it on its merry way. This method is also a little easier to understand, simply because your "query" is basically a URL string that you pass to the function, like so:

query_posts('meta_key=color&meta_value=blue'); 

On the other hand, WP_Query is more of a general purpose tool, and is more like directly writing MySQL queries than query_posts() is. You can also use it anywhere (not just in the Loop) and it doesn't interfere with any currently running post queries.

I tend to use WP_Query more often, as it happens. Really, it's going to come down to your specific case.

Iln'esttout simplementpasnécessaire d'utiliser query_posts().Tout ce qu'ilfait,c'estinstancier unnouvel objet WP_Queryet réaffecter cenouvel objet à global wp_query.

Pour référence,ce qui suitest lafonction query_posts() réelle.

  function query_posts($query) {
        $GLOBALS['wp_query'] = new WP_Query();
        return $GLOBALS['wp_query']->query($query);
    }
 

Instanciez votrepropre objet WP_Query si vous souhaitez créer un script de requêtepersonnaliséen profondeur.Ou utilisez get_posts() sitout ce que vous avez àfaireest une légèremanipulationiciet là.

Dans les deux cas,je vous recommande vivement de vous rendre serviceet d'aller à wp_includes/query.phpet deparcourir la classe WP_Query.

There is simply no need to use query_posts(). All it does is instantiates a new WP_Query object and reassigns that new object to global wp_query.

For reference, the following is that actual query_posts() function.

 function query_posts($query) {
        $GLOBALS['wp_query'] = new WP_Query();
        return $GLOBALS['wp_query']->query($query);
    }

Instantiate your own WP_Query object if you want to create an in depth custom query script. Or use get_posts() if all you need to do is some light manipulation here and there.

In either case, I highly recommend doing yourself a favor and going to wp_includes/query.php and perusing the WP_Query class.

Assurez-vous d'utiliser wp_reset_query() après avoir utilisé query_posts() car cela affectera également les autres résultats de la requête.

Make sure that you use wp_reset_query() after using query_posts() because it will affect other query result also.

Sije me souviensbien d'avoir lu,essentiellement "laboucle" consiste àfaire WP_Query dans lesfichiers debase,mais d'unemanièreplusfacile à comprendre.

If I recall reading right, essentially "the loop" is doing WP_Query in the core files, but in an easier to understand way.

• query_posts () :peut être utilisé dans un seulet unique cas si vous devezmodifiermainrequete .Il définit denombreuses variablesglobales;
• get_posts () :ilesttrès similaireen mécaniqueet accepte lesmêmes arguments,mais renvoie untableaudemessages
• WP_Query : vouspouvez créeret travailler avec votrepropre objet.Unpeuplus complexe,moins de restrictions,ilest sûr de l'utilisern'importe où.

• query_posts(): might be used in one and only case if you need to modify main query . It sets a lot of global variables;
• get_posts(): it is very similar in mechanics and accepts same arguments, but returns array of posts
• WP_Query:  you can create and work with own object of it. Bit more complex, less restrictions, it is safe to use anywhere.