Organiser le code dans le fichier functions.php de votre thème WordPress?

Question

Organiser le code dans le fichier functions.php de votre thème WordPress?

- 99
- 67464 2010-09-06
Plusje personnalise WordPress,plusje commence àme demander sije devrais organiser cefichier ou le diviser.

Plusprécisément,sij'ai untas defonctionspersonnalisées quine s'appliquent qu'à la zone d'administrationet d'autres quine s'appliquent qu'àmon site Webpublic,y a-t-il une raison d'inclure éventuellementtoutes lesfonctions d'administration dans leurproprefichier ou de les regrouper?
/p>
Lesfractionneren fichiers séparés ou les regrouperpourrait-il accélérer un site Web WordPress ou WordPress/PHP saute-t-il automatiquement lesfonctions qui ont unpréfixe de codeis_admin?

Quelleest lameilleurefaçon detraiter unfichier defonctions volumineux (lemien fait 1370 lignes).

The more customization I make to WordPress the more I start thinking about if I should be organizing this file or splitting it up.

More specifically, if I have a bunch of custom functions which only apply to the admin area and others which just apply to my public website is there any reason to possibly include all admin functions within their own file or group them together?

Would splitting them up into separate files or grouping them together possibly speed up a WordPress website or does WordPress/PHP automatically skip over functions which have an is_admin code prefix?

What's the best way to deal with a large functions file (mine is 1370 lines long).

wp-admin admin customization

8 réponses

votes

- 54
- 2012-10-13
Réponsetardive

Commentinclure correctement vosfichiers:

function wpse1403_bootstrap() { // Here we load from our includes directory // This considers parent and child themes as well locate_template( array( 'inc/foo.class.php' ), true, true ); } add_action( 'after_setup_theme', 'wpse1403_bootstrap' );

Lamême chosefonctionne également dans lesplugins.

Comment obtenir lebon chemin ou URi

Jetez également un œil auxfonctions de l'API du système defichierstelles que:

home_url()

plugin_dir_url()

plugin_dir_path()

admin_url()

get_template_directory()

get_template_directory_uri()

get_stylesheet_directory()

get_stylesheet_directory_uri()

etc.

Comment réduire lenombre de include/require

Si vous devez récupérer tous lesfichiers d'un répertoire,utilisez

foreach ( glob( 'path/to/folder/*.php' ) as $file ) include $file;

Gardez à l'esprit que celaignore les échecs (peut-êtrebonpour une utilisationen production)/lesfichiersnon chargeables.

Pourmodifier ce comportement,vouspouvez utiliser une configuration différentependant le développement:

$files = ( defined( 'WP_DEBUG' ) AND WP_DEBUG ) ? glob( 'path/to/folder/*.php', GLOB_ERR ) : glob( 'path/to/folder/*.php' ) foreach ( $files as $file ) include $file;

Edit: approche POO/SPL

En revenantjusteet en voyant que cette réponse reçoit deplusen plus de votespositifs,j'aipensé queje pourraismontrer commentje lefais denosjours - dans unmonde PHP 5.3+. L'exemple suivant chargetous lesfichiers d'un sous-dossier dethèmesnommé src/. C'est là quej'aimesbibliothèques quigèrent certainestâches comme lesmenus,lesimages,etc. Si vous avez d'autres sous-dossiers dans ce répertoire,ils sontignorés.

Le \FilesystemIteratorest le supercedor PHP 5.3+ sur \DirectoryIterator. Les deuxfontpartie du PHP SPL. Alors que PHP 5.2permettait de désactiver l'extension SPLintégrée (moins de 1% detoutes lesinstallations l'ontfait),le SPLfaitmaintenantpartie du cœur de PHP.

<?php namespace Theme; $files = new \FilesystemIterator( __DIR__.'/src', \FilesystemIterator::SKIP_DOTS ); foreach ( $files as $file ) { /** @noinspection PhpIncludeInspection */ ! $files->isDir() and include $files->getRealPath(); }

Auparavant,alors queje supportaistoujours PHP 5.2.x,j'utilisais la solution suivante: Un \FilterIterator dans le répertoire src/Filterspourne récupérer que lesfichiers (etnon dotpointeurs de dossiers)et un \DirectoryIteratorpourfaire lebouclageet le chargement. Thème d'espace denoms
namespace Theme; use Theme\Filters\IncludesFilter; $files = new IncludesFilter( new \DirectoryIterator( __DIR__.'/src' ) ); foreach ( $files as $file ) { include_once $files->current()->getRealPath(); }

Le \FilterIterator était aussi simple que cela:

<?php namespace Theme\Filters; class IncludesFilter extends \FilterIterator { public function accept() { return ! $this->current()->isDot() and $this->current()->isFile() and $this->current()->isReadable(); } }

Hormis lefait que PHP 5.2estmaintenantmort/EOL (et 5.3 également),il y a lefait qu'il y aplus de codeet unfichier deplus dans lejeu,iln'y a donc aucune raison d'utiliser leplus récentet de supporter PHP 5.2.x .

Résumé

EDIT Lamanière évidemment correcteest d'utiliser le code d namespace,préparépour PSR-4 autoloadingen mettanttout dans le répertoire approprié quiest déjà défini via l'espace denoms. Ensuite,utilisez simplement Composer et un composer.jsonpourgérer vos dépendanceset laissez-le automatiquement construisez votre chargeur automatique PHP (quiimporte automatiquement unfichieren appelant simplement use \<namespace>\ClassName). C'est lanorme defacto dans lemonde PHP,lemoyen leplus simpleet encorepluspré-automatiséet simplifiépar WP Démarreur .
Late answer

How to include your files the right way:

function wpse1403_bootstrap() { // Here we load from our includes directory // This considers parent and child themes as well locate_template( array( 'inc/foo.class.php' ), true, true ); } add_action( 'after_setup_theme', 'wpse1403_bootstrap' );

The same works in plugins too.

How to get the right path or URi

Also take a look at file system API functions like:

home_url()

plugin_dir_url()

plugin_dir_path()

admin_url()

get_template_directory()

get_template_directory_uri()

get_stylesheet_directory()

get_stylesheet_directory_uri()

etc.

How to reduce the number of include/require

If you need to fetch all files from a directory go with

foreach ( glob( 'path/to/folder/*.php' ) as $file ) include $file;

Keep in mind that this ignores failures (maybe good for production use)/not loadable files.

To alter this behavior you might want to use a different config during development:

$files = ( defined( 'WP_DEBUG' ) AND WP_DEBUG ) ? glob( 'path/to/folder/*.php', GLOB_ERR ) : glob( 'path/to/folder/*.php' ) foreach ( $files as $file ) include $file;

Edit: OOP/SPL approach

As I just came back and saw that this answer is getting more and more upvotes, I thought I might show how I'm doing it nowadays - in a PHP 5.3+ world. The following example loads all files from a themes subfolder named src/. This is where I have my libraries that handle certain tasks like menus, images, etc. You don't even have to care about the name as every single file gets loaded. If you have other subfolders in this directory, they get ignored.

The \FilesystemIterator is the PHP 5.3+ supercedor over the \DirectoryIterator. Both are part of the PHP SPL. While PHP 5.2 made it possible to turn the built in SPL extension off (below 1% of all installs did that), the SPL now is part of PHP core.

<?php namespace Theme; $files = new \FilesystemIterator( __DIR__.'/src', \FilesystemIterator::SKIP_DOTS ); foreach ( $files as $file ) { /** @noinspection PhpIncludeInspection */ ! $files->isDir() and include $files->getRealPath(); }

Previously while I still supported PHP 5.2.x, I used the following solution: A \FilterIterator in the src/Filters directory to only retrieve files (and not dot pointers of folders) and a \DirectoryIterator to do the looping and loading.
namespace Theme; use Theme\Filters\IncludesFilter; $files = new IncludesFilter( new \DirectoryIterator( __DIR__.'/src' ) ); foreach ( $files as $file ) { include_once $files->current()->getRealPath(); }

The \FilterIterator was as easy as that:

<?php namespace Theme\Filters; class IncludesFilter extends \FilterIterator { public function accept() { return ! $this->current()->isDot() and $this->current()->isFile() and $this->current()->isReadable(); } }

Aside from PHP 5.2 being dead/EOL by now (and 5.3 as well), there's the fact that it's more code and one more file in the game, so there's no reason to go with the later and support PHP 5.2.x.

Summed up

EDIT The obviously correct way is to use namespaced code, prepared for PSR-4 autoloading by putting everything in the appropriate directory that already is defined via the namespace. Then just use Composer and a composer.json to manage your dependencies and let it auto-build your PHP autoloader (that imports automatically a file by just calling use \<namespace>\ClassName). That's the de-facto standard in the PHP world, the easiest way to go and even more pre-automated and simplified by WP Starter.
- 6
- 2012-10-04
J'aime utiliser unefonctionpour lesfichiers dans un dossier. Cette approchefacilite l'ajout denouvellesfonctionnalités lors de l'ajout denouveauxfichiers. Maisj'écristoujoursen classe ou avec desespaces denoms - donnez-luiplus de contrôle sur l'espace denoms desfonctions,de laméthode,etc.

Ci-dessous unpetit exemple; ut également utiliser avec l'accord sur la classe * .php

public function __construct() { $this->load_classes(); } /** * Returns array of features, also * Scans the plugins subfolder "/classes" * * @since 0.1 * @return void */ protected function load_classes() { // load all files with the pattern class-*.php from the directory classes foreach( glob( dirname( __FILE__ ) . '/classes/class-*.php' ) as $class ) require_once $class; }

Dans lesthèmes,j'utilise souvent un autre scénario. Je définis lafonction dufichierexterne dans un ID de support,voir l'exemple. C'est utile sije désactivefacilement lafonction dufichierexternel. J'utilise lafonction debase WP require_if_theme_supports()et il se charge uniquement,si l'ID de support était actif. Dans l'exemple suivant,j'ai défini cet IDprisen charge dans la ligne avant de charger lefichier.

/** * Add support for Theme Customizer * * @since 09/06/2012 */ add_theme_support( 'documentation_customizer', array( 'all' ) ); // Include the theme customizer for options of theme options, if theme supported require_if_theme_supports( 'documentation_customizer', get_template_directory() . '/inc/theme-customize.php' );

Pouren savoirplus,consultez le repo de cethème .
I like to use a function to the files inside a folder. This approach makes it easy to add new features when adding new files. But I write always in class or with namespaces - give it more control about the Namespace of functions, method etc.

Below a small example; ut also useage with the agreement about the class*.php

public function __construct() { $this->load_classes(); } /** * Returns array of features, also * Scans the plugins subfolder "/classes" * * @since 0.1 * @return void */ protected function load_classes() { // load all files with the pattern class-*.php from the directory classes foreach( glob( dirname( __FILE__ ) . '/classes/class-*.php' ) as $class ) require_once $class; }

In Themes I use often a other scenario. I define the function of the externel file in a support ID, see the example. That is usefull if I will easy deactivate the feture of the externel file. I use the WP core function require_if_theme_supports() and he load only, if the support ID was active. In the follow example I deifned this supported ID in the line before load the file.

/** * Add support for Theme Customizer * * @since 09/06/2012 */ add_theme_support( 'documentation_customizer', array( 'all' ) ); // Include the theme customizer for options of theme options, if theme supported require_if_theme_supports( 'documentation_customizer', get_template_directory() . '/inc/theme-customize.php' );

You can see more of this in the repo of this theme.

5

2010-09-06

Entermes de décomposition,dansmaplaque chauffante,j'utilise unefonctionpersonnaliséepour rechercher un dossier appeléfunctions dans le répertoire duthème,s'iln'estpas là,il le crée. Puis crée untableau detous lesfichiers .php qu'iltrouve dans ce dossier (le cas échéant)et exécute uninclude (); sur chacun d'eux.

De cettefaçon,chaquefois quej'aibesoin d'écrire denouvellesfonctionnalités,j'ajoute simplement unfichier PHP dans le dossierfunctions,et jen'aipas àme soucier de le coder dans le site.

 <?php
/* 
FUNCTIONS for automatically including php documents from the functions folder.
*/
//if running on php4, make a scandir functions
if (!function_exists('scandir')) {
  function scandir($directory, $sorting_order = 0) {
    $dh = opendir($directory);
    while (false !== ($filename = readdir($dh))) {
      $files[] = $filename;
    }
    if ($sorting_order == 0) {
      sort($files);
    } else {
      rsort($files);
    }
    return ($files);
  }
}
/*
* this function returns the path to the funtions folder.
* If the folder does not exist, it creates it.
*/
function get_function_directory_extension($template_url = FALSE) {
  //get template url if not passed
  if (!$template_url)$template_url = get_bloginfo('template_directory');


  //replace slashes with dashes for explode
  $template_url_no_slash = str_replace('/', '.', $template_url);

  //create array from URL
  $template_url_array = explode('.', $template_url_no_slash);

  //--splice array

  //Calculate offset(we only need the last three levels)
  //We need to do this to get the proper directory, not the one passed by the server, as scandir doesn't work when aliases get involved.
  $offset = count($template_url_array) - 3;

  //splice array, only keeping back to the root WP install folder (where wp-config.php lives, where the front end runs from)
  $template_url_array = array_splice($template_url_array, $offset, 3);
  //put back togther as string
  $template_url_return_string = implode('/', $template_url_array);
  fb::log($template_url_return_string, 'Template'); //firephp

  //creates current working directory with template extention and functions directory    
  //if admin, change out of admin folder before storing working dir, then change back again.
  if (is_admin()) {
    $admin_directory = getcwd();
    chdir("..");
    $current_working_directory = getcwd();
    chdir($admin_directory);
  } else {
    $current_working_directory = getcwd();
  }
  fb::log($current_working_directory, 'Directory'); //firephp

  //alternate method is chdir method doesn't work on your server (some windows servers might not like it)
  //if (is_admin()) $current_working_directory = str_replace('/wp-admin','',$current_working_directory);

  $function_folder = $current_working_directory . '/' . $template_url_return_string . '/functions';


  if (!is_dir($function_folder)) mkdir($function_folder); //make folder, if it doesn't already exist (lazy, but useful....ish)
  //return path
  return $function_folder;

}

//removed array elements that do not have extension .php
function only_php_files($scan_dir_list = false) {
  if (!$scan_dir_list || !is_array($scan_dir_list)) return false; //if element not given, or not array, return out of function.
  foreach ($scan_dir_list as $key => $value) {
    if (!strpos($value, '.php')) {

      unset($scan_dir_list[$key]);
    }
  }
  return $scan_dir_list;
}
//runs the functions to create function folder, select it,
//scan it, filter only PHP docs then include them in functions

add_action('wp_head', fetch_php_docs_from_functions_folder(), 1);
function fetch_php_docs_from_functions_folder() {

  //get function directory
  $functions_dir = get_function_directory_extension();
  //scan directory, and strip non-php docs
  $all_php_docs = only_php_files(scandir($functions_dir));

  //include php docs
  if (is_array($all_php_docs)) {
    foreach ($all_php_docs as $include) {
      include($functions_dir . '/' . $include);
    }
  }

}

in terms of breaking it up, in my boiler plate I use a custom function to look for a folder called functions in the theme directory, if it is not there it creates it. Then is creates an array of all the .php files it finds in that folder (if any) and runs an include(); on each of them.

That way, each time I need to write some new functionality, I just add a PHP file to the functions folder, and don't have to worry about coding it into the site.

<?php
/* 
FUNCTIONS for automatically including php documents from the functions folder.
*/
//if running on php4, make a scandir functions
if (!function_exists('scandir')) {
  function scandir($directory, $sorting_order = 0) {
    $dh = opendir($directory);
    while (false !== ($filename = readdir($dh))) {
      $files[] = $filename;
    }
    if ($sorting_order == 0) {
      sort($files);
    } else {
      rsort($files);
    }
    return ($files);
  }
}
/*
* this function returns the path to the funtions folder.
* If the folder does not exist, it creates it.
*/
function get_function_directory_extension($template_url = FALSE) {
  //get template url if not passed
  if (!$template_url)$template_url = get_bloginfo('template_directory');


  //replace slashes with dashes for explode
  $template_url_no_slash = str_replace('/', '.', $template_url);

  //create array from URL
  $template_url_array = explode('.', $template_url_no_slash);

  //--splice array

  //Calculate offset(we only need the last three levels)
  //We need to do this to get the proper directory, not the one passed by the server, as scandir doesn't work when aliases get involved.
  $offset = count($template_url_array) - 3;

  //splice array, only keeping back to the root WP install folder (where wp-config.php lives, where the front end runs from)
  $template_url_array = array_splice($template_url_array, $offset, 3);
  //put back togther as string
  $template_url_return_string = implode('/', $template_url_array);
  fb::log($template_url_return_string, 'Template'); //firephp

  //creates current working directory with template extention and functions directory    
  //if admin, change out of admin folder before storing working dir, then change back again.
  if (is_admin()) {
    $admin_directory = getcwd();
    chdir("..");
    $current_working_directory = getcwd();
    chdir($admin_directory);
  } else {
    $current_working_directory = getcwd();
  }
  fb::log($current_working_directory, 'Directory'); //firephp

  //alternate method is chdir method doesn't work on your server (some windows servers might not like it)
  //if (is_admin()) $current_working_directory = str_replace('/wp-admin','',$current_working_directory);

  $function_folder = $current_working_directory . '/' . $template_url_return_string . '/functions';


  if (!is_dir($function_folder)) mkdir($function_folder); //make folder, if it doesn't already exist (lazy, but useful....ish)
  //return path
  return $function_folder;

}

//removed array elements that do not have extension .php
function only_php_files($scan_dir_list = false) {
  if (!$scan_dir_list || !is_array($scan_dir_list)) return false; //if element not given, or not array, return out of function.
  foreach ($scan_dir_list as $key => $value) {
    if (!strpos($value, '.php')) {

      unset($scan_dir_list[$key]);
    }
  }
  return $scan_dir_list;
}
//runs the functions to create function folder, select it,
//scan it, filter only PHP docs then include them in functions

add_action('wp_head', fetch_php_docs_from_functions_folder(), 1);
function fetch_php_docs_from_functions_folder() {

  //get function directory
  $functions_dir = get_function_directory_extension();
  //scan directory, and strip non-php docs
  $all_php_docs = only_php_files(scandir($functions_dir));

  //include php docs
  if (is_array($all_php_docs)) {
    foreach ($all_php_docs as $include) {
      include($functions_dir . '/' . $include);
    }
  }

}

* @mildfuzz *: Belle astuce.Personnellement,je ne l'utiliseraispaspour le code deproduction,caril chargepour chaquepage ce quenouspourrionsfacilementfaire unefois lorsquenous lançons le site.Deplus,j'ajouterais d'unemanière ou d'une autrepour omettre lesfichiers,commene rien charger commençantpar untrait de soulignement afin queje puissetoujours stocker lestravauxen cours dans le répertoire duthème.Sinon,c'estbien!

*@mildfuzz*: Nice trick. I personally wouldn't use it for production code because it does for every page load what we could easily do once when we launch the site. Also, I'd add in some way to omit files, like not loading anything starting with an underscore so I could still store works in progress in the theme directory. Otherwise, nice!
- 5
- 2010-09-06
- MikeSchinkel
J'adore l'idéemaisje suis d'accord que celapourrait éventuellemententraîner un chargementinutilepour chaque demande.Uneidée s'il y aurait unmoyen simple degénérer automatiquement lefichierfunctions.phpfinalen cache avec untype demise àjour si/quand denouveauxfichiers sont ajoutés ou à unintervalle detemps spécifique?

love the idea but I agree this might possibly lead to unnecessary loading for each request. Any idea if there would be a simple way to have the final functions.php file being generated automatically cached with some type of update if/when new files are added or at a specific time interval?
- 0
- 2010-09-07
- NetConstructor.com
Bienmais cela conduit à desinflexibilités,que sepasse-t-il également si un attaquantparvient à y déposer son code?Et si l'ordre des comprendestimportant?

Nice but it leads to inflexibilities, also what happens if an attacker manages to drop their code in there? And what if the ordering of includes is important?
- 0
- 2010-09-07
- Tom J Nowell
@MikeSchinkel J'appelle simplementmesfichiers detravailfoo._php,puisje laissetomber le _php quandje veux qu'il s'exécute.

@MikeSchinkel I just call my working files foo._php, then drop the _php when I want it to run.
- 1
- 2010-09-10
- Mild Fuzz
@NetConstructor: Serait égalementintéressépar une solution.

@NetConstructor: Would be interested in some sollution too.
- 0
- 2011-02-01
- kaiser
@kaiser,je suppose que vouspouvez lefaire avec des scripts cronexécutant unefonction quiexécute la recherche de dossier ci-dessusmais écrit les résultats dans un DB/fichiertexte,puisbase les charges sur cettefonction.Celapourrait également conduire à untravailinachevé dans la charge.

@kaiser, I suppose you could do it with cron scripts running a function that run's the above folder search but writes the results to a DB/textfile, then bases the loads on that function. This could potentially lead to unfinished work going into the load also.
- 0
- 2011-02-01
- Mild Fuzz
@MildFuzz: Mike vient deme diriger vers l'API destransitoires.Peut-être que celapourraitfairepartie d'une sorte de solution ...

@MildFuzz: Mike just pointed me at the transients API. Maybe that could get part of some sort of sollution...
- 0
- 2011-02-01
- kaiser
basé sur la solution décritepar @mildfuzz - quelleest selon vous lameilleureméthodepourexclure automatiquementtoutfichier ou dossier (et ses sous-fichiers/dossiers) d'êtreinclus dans son approche d'inclusion automatique?Mapensée serait d'utiliser l'approche de soulignement commepréfixe.Quel code approprié serait lameilleure approchepourinclure detelles capacités?

based on the solution outlined by @mildfuzz - what do you guys believe to be the best method to automatically exclude any file or folder (and its subfiles/folders) from being included within his auto-include approach? My thought would be to use the underscore approach as a prefix. What proper code would be the best approach to include such capabilities?
- 0
- 2012-10-10
- NetConstructor.com
il vous suffit de changer `if (! strpos ($ value,'.php'))`pourinclure le système que vous choisissez.

you just need to change `if (!strpos($value, '.php'))` to include whatever system you choose.
- 0
- 2012-10-10
- Mild Fuzz

- 4
- 2012-10-04
Jegère un site avecenviron 50types depagespersonnalisées uniques dansplusieurs langues différentes sur uneinstallation réseau. Avec unetonne deplugins.

Nous avons été obligés detout diviser à unmoment donné. Unfichier defonctions avec 20 à 30 000 lignes de coden'estpas dutout drôle.

Nous avons décidé de refactoriser complètementtout le code afin demieuxgérer labase de code. La structure dethème WordPresspar défaut convient auxpetits sites,maispas auxgrands sites.

Notrenouveaufunctions.phpne contient que ce quiestnécessairepour démarrer le site,mais rien qui appartient à unepage spécifique.

La disposition dethème quenous utilisonsmaintenantest similaire aumodèle de conception MCV,mais dans un style de codageprocédural.

Parexemple,notre pagemembre:

page-member.php . Responsable de l'initialisation de lapage. Appel desfonctions ajax correctes ou similaire. Peut être équivalent à lapartie Controller dans le style MCV.

fonctions-membre.php . Contienttoutes lesfonctions liées à cettepage. Ceciest égalementinclus dansplusieurs autrespages qui ontbesoin defonctionspournosmembres.

content-member.php . Prépare les donnéespour HTML Peut être équivalente aumodèle dans MCV.

layout-member.php . Lapartie HTML.

Après avoireffectué ces changements,letemps de développement afacilement diminué de 50%et maintenant lepropriétaire duproduit a dumal ànous confier denouvellestâches. :)

I manage a site with about 50 unique custom page types in serveral different languages over a network installation. Along with a TON of plugins.

We where forced to split it all up at some point. A functions file with 20-30k lines of code is not funny at all.

We decided to completley refactor all code in order to manage the codebase better. The default wordpress theme structure is good for small sites, but not for bigger sites.

Our new functions.php only contains what is necessary to start the site, but nothing which belongs to a specific page.

The theme layout we use now is similar to the MCV design pattern, but in a procedural coding style.

For example our member page:

page-member.php. Responsible for initializing the page. Calling the correct ajax functions or similar. Could be equivialent to the Controller part in the MCV style.

functions-member.php. Contains all functions related to this page. This is also included in serveral other pages which need functions for our members.

content-member.php. Prepares the data for HTML Could be equivialent to the Model in MCV.

layout-member.php. The HTML part.

Efter we did these changes the development time have easily dropped by 50% and now the product owner have trouble giving us new tasks. :)
- Pour rendre celaplus utile,vouspouvezenvisager demontrer comment cemodèle MVCfonctionne réellement.
  
  To make this more helpful you might consider showing how this MVC pattern really works.
  - 7
  - 2012-10-05
  - kaiser
- Je serais également curieux de voir unexemple de votre approche,depréférence avec quelques détails/diverses situations.L'approche sembletrèsintéressante.Avez-vous comparé la charge/lesperformances du serveur avec laméthodologie standard utiliséepar d'autres?fournissez unexemplegithub sipossible.
  
  i would also be currious to see an example of your approach, preferably with some details/various situations. The approach sounds very interresting. Have you compared server load/performance with the standard methodology others use? do provide a github example if at all possible.
  - 0
  - 2012-10-10
  - NetConstructor.com

3

2013-10-20

Depuis lefichierfunctions.php desthèmesenfants:

     require_once( get_stylesheet_directory() . '/inc/custom.php' );

From child themes functions.php file:

    require_once( get_stylesheet_directory() . '/inc/custom.php' );

- 0
- 2012-10-04
Dansfunctions.php,unemanièreplus élégante d'appeler unfichier requis serait:

require_once Locate_template ('/inc/functions/shortcodes.php');

In functions.php, a more elegant way to call a required file would be:

require_once locate_template('/inc/functions/shortcodes.php');
- [`Locate_template ()`] (http://codex.wordpress.org/Function_Reference/locate_template) a untroisièmeparamètre…
  
  [`locate_template()`](http://codex.wordpress.org/Function_Reference/locate_template) has a third parameter …
  - 4
  - 2012-10-04
  - fuxia

0

2018-08-19

J'ai combiné @kaiser et Réponses de @mikeschinkel .

J'aitoutesmespersonnalisations demonthème dans un dossier /includeset dans ce dossier,toutest diviséen sous-dossiers.

Je veux que /includes/adminet ses sous-contenus soientinclus uniquement lorsque true === is_admin()

Si un dossierestexclu dans iterator_check_traversal_callbacken renvoyant false alors ses sous-répertoiresne serontpasitérés (outransmis à iterator_check_traversal_callback)

 /**
 *  Require all customizations under /includes
 */
$includes_import_root = 
    new \RecursiveDirectoryIterator( __DIR__ . '/includes', \FilesystemIterator::SKIP_DOTS );

function iterator_check_traversal_callback( $current, $key, $iterator ) {
    $file_name = $current->getFilename();

    // Only include *.php files
    if ( ! $current->isDir() ) {
        return preg_match( '/^.+\.php$/i', $file_name );
    }

    // Don't include the /includes/admin folder when on the public site
    return 'admin' === $file_name
        ? is_admin()
        : true;
}

$iterator_filter = new \RecursiveCallbackFilterIterator(
    $includes_import_root, 'iterator_check_traversal_callback'
);

foreach ( new \RecursiveIteratorIterator( $iterator_filter ) as $file ) {
    include $file->getRealPath();
}

I combined @kaiser's and @mikeschinkel's answers.

I have all my customizations to my theme in a /includes folder and within that folder I have everything broken out into sub folders.

I only want /includes/admin and its sub-contents to be included when true === is_admin()

If a folder is excluded in iterator_check_traversal_callback by returning false then its sub-directories will not be iterated (or passed to iterator_check_traversal_callback)

/**
 *  Require all customizations under /includes
 */
$includes_import_root = 
    new \RecursiveDirectoryIterator( __DIR__ . '/includes', \FilesystemIterator::SKIP_DOTS );

function iterator_check_traversal_callback( $current, $key, $iterator ) {
    $file_name = $current->getFilename();

    // Only include *.php files
    if ( ! $current->isDir() ) {
        return preg_match( '/^.+\.php$/i', $file_name );
    }

    // Don't include the /includes/admin folder when on the public site
    return 'admin' === $file_name
        ? is_admin()
        : true;
}

$iterator_filter = new \RecursiveCallbackFilterIterator(
    $includes_import_root, 'iterator_check_traversal_callback'
);

foreach ( new \RecursiveIteratorIterator( $iterator_filter ) as $file ) {
    include $file->getRealPath();
}

MikeSchinkel · Accepted Answer · 2010-09-06

128

2010-09-06

Si vous arrivez aupoint où le code dans functions.php de votrethème commence à vous submerger,je dirais certainement que vous êtesprêt àenvisager de le diviseren plusieursfichiers. J'aitendance àfaire celapresquepar secondenature à ce stade.

Utilisez Inclure lesfichiers dans lefichier `functions.php`

de votrethème

Je crée un sous-répertoire appelé "includes" sousmon répertoire dethèmeset segmentemon codeen fichiers d'inclusion organisésen fonction de ce qui a du senspourmoi à cemoment-là (ce qui signifie queje refactoreet déplace constamment du code àmesure qu'un site évolue.) Jemets aussi rarement du vrai code dans functions.php;tout va dans lesfichiers d'inclusion;justemapréférence.

Justepour vous donner unexemple,voicimoninstallation detest quej'utilisepourtestermes réponses aux questionsici sur WordPress Answers. Chaquefois queje réponds à une question,je garde le code au cas oùj'en aurais ànouveaubesoin. Cen'estpasexactement ce que vousferezpour un siteen direct,mais celamontre lesmécanismes defractionnement du code:

 <?php 
/*
 * functions.php
 * 
 */
require_once( __DIR__ . '/includes/null-meta-compare.php');
require_once( __DIR__ . '/includes/older-examples.php');
require_once( __DIR__ . '/includes/wp-admin-menu-classes.php');
require_once( __DIR__ . '/includes/admin-menu-function-examples.php');

// WA: Adding a Taxonomy Filter to Admin List for a Custom Post Type?
// http://wordpress.stackexchange.com/questions/578/
require_once( __DIR__ . '/includes/cpt-filtering-in-admin.php'); 
require_once( __DIR__ . '/includes/category-fields.php');
require_once( __DIR__ . '/includes/post-list-shortcode.php');
require_once( __DIR__ . '/includes/car-type-urls.php');
require_once( __DIR__ . '/includes/buffer-all.php');
require_once( __DIR__ . '/includes/get-page-selector.php');

// http://wordpress.stackexchange.com/questions/907/
require_once( __DIR__ . '/includes/top-5-posts-per-category.php'); 

// http://wordpress.stackexchange.com/questions/951/
require_once( __DIR__ . '/includes/alternate-category-metabox.php');  

// http://lists.automattic.com/pipermail/wp-hackers/2010-August/034384.html
require_once( __DIR__ . '/includes/remove-status.php');  

// http://wordpress.stackexchange.com/questions/1027/removing-the-your-backup-folder-might-be-visible-to-the-public-message-generate
require_once( __DIR__ . '/includes/301-redirects.php');

Ou créer desplugins

Une autre optionpour commencer à regrouper votre codeparfonctionet créer vospropresplugins. Pourmoi,je commence à coder dans lefichier functions.php duthèmeet aumoment oùje reçois le code étoffé,j'ai déplacé laplupart demon code dans desplugins.

Cependant,AUCUNgain deperformances significatif de l'organisation du code PHP

D'autrepart,structurer vosfichiers PHP revient à 99% à créer de l'ordreet à lamaintenabilitéet à 1% à desperformances,si cela (l'organisation desfichiers .jset .css appeléspar lenavigateur via HTTPest un cas complètement différentet a d'énormesimplications sur lesperformances.) Mais lafaçon dont vous organisez votre code PHP sur le serveurn'apas d'importance dupoint de vue desperformances.

Et l'organisation du codeest unepréférencepersonnelle

Enfin,l'organisation du codeest lapréférencepersonnelle. Certainespersonnes détesteraient lafaçon dontj'organise le code,tout commeje détesteraispeut-être lafaçon dontils lefont aussi. Trouvez quelque chose que vous aimezet tenez-vous-y,mais laissez votre stratégie évoluer aufil dutemps aufuret àmesure que vousen apprenezpluset que vous vousfamiliarisez avecelle.

If you are getting to the point where the code in your theme's functions.php is starting to overwhelm you I would definitely say you are ready to consider splitting it up into multiple files. I tend to do that almost by second nature at this point.

Use Include Files in your Theme's `functions.php` File

I create a subdirectory called "includes" under my theme directory and segment my code into include files organized by what makes sense to me at the time (which means I'm constantly refactoring and moving code around as a site evolves.) I also rarely put any real code in functions.php; everything goes in the include files; just my preference.

Just to give you an example here's my test install that I use to test my answers to questions here on WordPress Answers. Every time I answer a question I keep the code around in case I need it again. This isn't exactly what you'll do for a live site but it shows the mechanics of splitting up the code:

<?php 
/*
 * functions.php
 * 
 */
require_once( __DIR__ . '/includes/null-meta-compare.php');
require_once( __DIR__ . '/includes/older-examples.php');
require_once( __DIR__ . '/includes/wp-admin-menu-classes.php');
require_once( __DIR__ . '/includes/admin-menu-function-examples.php');

// WA: Adding a Taxonomy Filter to Admin List for a Custom Post Type?
// http://wordpress.stackexchange.com/questions/578/
require_once( __DIR__ . '/includes/cpt-filtering-in-admin.php'); 
require_once( __DIR__ . '/includes/category-fields.php');
require_once( __DIR__ . '/includes/post-list-shortcode.php');
require_once( __DIR__ . '/includes/car-type-urls.php');
require_once( __DIR__ . '/includes/buffer-all.php');
require_once( __DIR__ . '/includes/get-page-selector.php');

// http://wordpress.stackexchange.com/questions/907/
require_once( __DIR__ . '/includes/top-5-posts-per-category.php'); 

// http://wordpress.stackexchange.com/questions/951/
require_once( __DIR__ . '/includes/alternate-category-metabox.php');  

// http://lists.automattic.com/pipermail/wp-hackers/2010-August/034384.html
require_once( __DIR__ . '/includes/remove-status.php');  

// http://wordpress.stackexchange.com/questions/1027/removing-the-your-backup-folder-might-be-visible-to-the-public-message-generate
require_once( __DIR__ . '/includes/301-redirects.php');

Or Create Plugins

Another option it to start grouping your code by function and create your own plugins. For me I start coding in the theme's functions.php file and by the time I get the code fleshed out I've moved most of my code into plugins.

However NO Significant Performance Gain From PHP Code Organization

On the other hand structuring your PHP files is 99% about creating order and maintainability and 1% about performance, if that (organizing .js and .css files called by the browser via HTTP is a completely different case and has huge performance implications.) But how you organize your PHP code on the server pretty much doesn't matter from a performance perspective.

And Code Organization is Personal Preference

And last but not least code organization is personal preference. Some people would hate how I organize code just as I might hate how they do it too. Find something you like and stick with it, but allow your strategy to evolve over time as you learn more and get more comfortable with it.

Bonne réponse,je viens d'arriver à cepoint oùje dois diviser lefichier defonctions.Quandpensez-vous qu'ilestpratique depasser defrunctions.php à unplugin.Vous avez dit dans votre réponse: _ aumoment oùj'élabore le code,j'ai déplacé laplupart demon code dans desplugins_.Jene comprendspastout àfait cela,qu'entendez-vouspar étoffé.

Nice answer, I just arrived to this point where i need to split the functions file. When do you think it's handy to move from frunctions.php to a plugin. You said in your answer: _by the time I get the code fleshed out I've moved most of my code into plugins_. I do not understand that fully, what do you mean with fleshed out.
- 0
- 2011-08-16
- Saif Bechan
+1pour "ou créer desplugins".Plusprécisément,"[plugins defonctionnalités] (http://www.doitwithwp.com/create-functions-plugin/)"

+1 for "or create plugins". More specifically, "[functionality plugins](http://www.doitwithwp.com/create-functions-plugin/)"
- 5
- 2012-04-18
- Ian Dunn
l'utilisation de chemins relatifspeutne pas êtrefiable danstous lestypes deparamètres,le chemin absolu doittoujours être utilisé à laplace

using relative paths might not be reliable in all kinds of settings, absolute path should always be used instead
- 3
- 2016-09-22
- Mark Kaplun
@MarkKaplun - Vous avez ** absolument ** raison.Depuis quej'ai écrit cette réponse,j'ai appris cette leçon à la dure.Je vaismettre àjourma réponse.Merci de l'avoir signalé.

@MarkKaplun - You are **absolutely** correct. Since I wrote this answer I learned that lesson the hard way. I am going to update my answer. Thanks for pointing this out.
- 2
- 2016-09-23
- MikeSchinkel
J'obtiens "Utilisation de la constante __DIR__non définie - supposé '__DIR__' dans C: \ wamp \ www \ site \ wp-content \themes \mytheme \functions.php" - PHP v5.6.25et PHP v7.0.10 - Jene peuxpasformater correctement ce DIRen commentaire (underscoreunderscoreDIRunderscoreunderscore),mais celafonctionne avec dirname (underscoreunderscoreFILEunderscoreunderscore)

I get "Use of undefined constant __DIR__ - assumed '__DIR__' in C:\wamp\www\site\wp-content\themes\mytheme\functions.php" - PHP v5.6.25 and PHP v7.0.10 - I can't format properly this DIR in comment (underscoreunderscoreDIRunderscoreunderscore), but it works with dirname(underscoreunderscoreFILEunderscoreunderscore)
- 0
- 2016-11-01
- Marko
Attention: vous devrez utiliser `__DIR__` au lieu de` __DIR ___ `,sinon vous serezprésenté avec uneerreur de serveurinterne (500).

Caution: you'd need to use `__DIR__` instead of `__DIR___`, otherwise you'll be presented with an Internal Server Error (500).
- 0
- 2017-02-13
- robro
@robro - Ah,merci d'avoir attrapé ça!_ (Merdefautes defrappe. Grrr ...) _ :-)

@robro - Ah, thanks for catching that! _(Damn typos. Grrr...)_ :-)
- 0
- 2017-02-13
- MikeSchinkel

Organiser le code dans le fichier functions.php de votre thème WordPress?

8 réponses

Utilisez Inclure lesfichiers dans lefichier `functions.php`

Ou créer desplugins

Cependant,AUCUNgain deperformances significatif de l'organisation du code PHP

Et l'organisation du codeest unepréférencepersonnelle

Use Include Files in your Theme's `functions.php` File

Or Create Plugins

However NO Significant Performance Gain From PHP Code Organization

And Code Organization is Personal Preference

Commentinclure correctement vosfichiers:

Comment obtenir lebon chemin ou URi

Comment réduire lenombre de `include/require`

Edit: approche POO/SPL

Résumé

How to include your files the right way:

How to get the right path or URi

How to reduce the number of `include/require`

Edit: OOP/SPL approach

Summed up

Organiser le code dans le fichier functions.php de votre thème WordPress?

8 réponses

Utilisez Inclure lesfichiers dans lefichier functions.php

Ou créer desplugins

Cependant,AUCUNgain deperformances significatif de l'organisation du code PHP

Et l'organisation du codeest unepréférencepersonnelle

Use Include Files in your Theme's functions.php File

Or Create Plugins

However NO Significant Performance Gain From PHP Code Organization

And Code Organization is Personal Preference

Commentinclure correctement vosfichiers:

Comment obtenir lebon chemin ou URi

Comment réduire lenombre de include/require

Edit: approche POO/SPL

Résumé

How to include your files the right way:

How to get the right path or URi

How to reduce the number of include/require

Edit: OOP/SPL approach

Summed up

Utilisez Inclure lesfichiers dans lefichier `functions.php`

Use Include Files in your Theme's `functions.php` File

Comment réduire lenombre de `include/require`

How to reduce the number of `include/require`