单个functions.php还是分成许多小文件?


14

我正在创建一个带有主题选项的简单框架。我在其中划分了代码块functions.php并将其放置在特定的文件夹结构中。

现在在我的主functions.php文件中,我只有require_once这些文件的调用。

但是为了争论起见-假设我将要包含20个文件。

问题:

  1. 这是否以可见的方式影响WP性能?
  2. 最好将其全部保存在1个文件中(functions.php)
  3. 最好的方法是什么?

谢谢。

Answers:


12

1.这是否以可见的方式影响WP性能?

如果它将对某些小文件产生实际影响,则其影响将小于WP:PHP和服务器性能。真的有影响吗?并不是的。但是您仍然可以自己开始进行性能测试。

2.最好将其全部保存在1个文件中(functions.php)

现在的问题是“哪个更好”?从整体文件加载时间来看?从文件组织的角度来看?无论如何,它没有任何区别。这样做的目的是使您不会失去概览,并且可以以对您而言令人愉悦的方式保持结果。

3.最好的方法是什么?

我通常所做的只是简单地将钩子挂在(plugins_loadedafter_setup_theme等。-取决于您所需要的)中,然后只要求它们全部:

foreach ( glob( plugin_dir_path( __FILE__ ) ) as $file )
    require_once $file;

无论如何,您也可以使其更加复杂和灵活。看一下这个例子:

<?php

namespace WCM;

defined( 'ABSPATH' ) OR exit;

class FilesLoader implements \IteratorAggregate
{
    private $path = '';

    private $files = array();

    public function __construct( $path )
    {
        $this->setPath( $path );
        $this->setFiles();
    }

    public function setPath( $path )
    {
        if ( empty( $this->path ) )
            $this->path = \plugin_dir_path( __FILE__ ).$path;
    }

    public function setFiles()
    {
        return $this->files = glob( "{$this->getPath()}/*.php" );
    }

    public function getPath()
    {
        return $this->path;
    }

    public function getFiles()
    {
        return $this->files;
    }

    public function getIterator()
    {
        $iterator = new \ArrayIterator( $this->getFiles() );
        return $iterator;
    }

    public function loadFile( $file )
    {
        include_once $file;
    }
}

这是一个基本相同的类(需要PHP 5.3+)。好处是它的粒度更精细,因此您可以轻松地从需要执行特定任务的文件夹中加载文件:

$fileLoader = new WCM\FilesLoader( 'assets/php' );

foreach ( $fileLoader as $file )
    $fileLoader->loadFile( $file );

更新资料

当我们生活在一个新的PHP v5.2之后的世界中时,我们可以使用\FilterIterator。最短变体的示例:

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

如果您必须坚持使用PHP v5.2,那么仍然可以使用\DirectoryIterator和几乎相同的代码。


凉。谢谢您的解释:)检查特定文件夹中的文件可能对我的工作没有帮助,尽管这是一个好主意。我正在尝试制作一个模块化的框架。因此,所有“模块”都位于单独的文件中,这些文件将在functions.php中作为单独的条目(require_once)列出。这样,如果有人不想包括其中一个模块(例如:theme-customizer),则可以将其注释掉,等等。无论如何,这就是计划:)再次感谢。
MegaMan

@MegaMan您最好在调用loadFile()或之前过滤输出require_once。因此,只需提供诸如主题支持之类的东西,用户自己就可以add_theme_support()/remove_*()仅使用他想要的模块。然后只需将结果用于$loadFile()glob()。顺便说一句,如果这是您的解决方案,请将其标记为此类。谢谢。
kaiser

0

我对@kaiser做了一些修改,以回答我的需求-以为我可以分享。我想要更多选项,这些选项在代码内以及下面的用法示例中进行了说明。

码:

<?php

defined( 'ABSPATH' ) OR exit;

/**
 * Functions_File_Loader
 * 
 * Makes it possible to clutter the functions.php into single files.
 * 
 * @author kaiser
 * @author ialocin
 * @link http://wordpress.stackexchange.com/q/111970/22534
 *
 */

class Functions_File_Loader implements IteratorAggregate {

    /**
     * @var array
     */
    private $parameter = array();

    /**
     * @var string
     */
    private $path;

    /**
     * @var string
     */
    private $pattern;

    /**
     * @var integer
     */
    private $flags;

    /**
     * @var array
     */
    private $files = array();

    /**
     * __construct
     *
     * @access public 
     * @param array $parameter
     */
    public function __construct( $parameter ) {
        $this->set_parameter( $parameter );
        $this->set_path( $this->parameter[ 'path' ] );
        $this->set_pattern( $this->parameter[ 'pattern' ] );
        $this->set_flags( $this->parameter[ 'flags' ] );
        $this->set_files();
    }

    /**
     * set_parameter
     *
     * @access public 
     * @param array $parameter
     */
    public function set_parameter( $parameter ) {
        if ( empty( $parameter ) )
            $this->parameter = array('','','');
        else
            $this->parameter = $parameter;
    }

    /**
     * get_parameter
     *
     * @access public 
     * @return array
     */
    public function get_parameter() {
        return $this->parameter;
    }

    /**
     * set_path
     *
     * defaults to get_stylesheet_directory()
     * 
     * @access public 
     * @param string $path
     */
    public function set_path( $path ) {
        if ( empty( $path ) )
            $this->path = get_stylesheet_directory().'/';
        else
            $this->path = get_stylesheet_directory().'/'.$path.'/';
    }

    /**
     * get_path
     *
     * @access public 
     * @return string
     */
    public function get_path() {
        return $this->path;
    }

    /**
     * set_pattern
     *
     * defaults to path plus asterisk »*«
     * 
     * @access public 
     * @param string $pattern
     */
    public function set_pattern( $pattern ) {
        if ( empty( $pattern ) )
            $this->pattern = $this->get_path() . '*';
        else
            $this->pattern = $this->get_path() . $pattern;
    }

    /**
     * get_pattern
     *
     * @access public 
     * @return string
     */
    public function get_pattern() {
        return $this->pattern;
    }

    /**
     * set_flags
     *
     * @access public 
     * @param integer $flags
     */
    public function set_flags( $flags ) {
        if ( empty( $flags ) )
            $this->flags = '0';
        else
            $this->flags = $flags;
    }

    /**
     * get_flags
     *
     * @access public 
     * @return integer
     */
    public function get_flags() {
        return $this->flags;
    }


    /**
     * set_files
     *
     * @access public 
     */
    public function set_files() {
        $pattern = $this->get_pattern();
        $flags = $this->get_flags();
        $files = glob( $pattern, $flags );
        $this->files = $files;
    }


    /**
     * get_files
     *
     * @access public 
     * @return array
     */
    public function get_files() {
        return $this->files;
    }

    /**
     * getIterator
     * 
     * This function name has to be kept
     * 
     * @access public 
     * @return void
     */
    public function getIterator() {
        $iterator = new ArrayIterator( $this->get_files() );
        return $iterator;
    }

    /**
     * load_file
     *
     * @access public 
     * @param string $file
     */
    public function load_file( $file ) {
        include_once $file;
    }
}


用法示例:

$parameter = array(
        // define path relative to get_stylesheet_directory()
        // optional, defaults to get_stylesheet_directory()
        'path' => 'includes/plugins',
        // optional, defaults to asterisk »*«
        // matches all files ending with ».php« 
        // and not beginning with »_«, good for quickly deactivating 
        // directories searched are »path« and »subfolders«
        // Additional examples:
        // '{*/,}{[!_],}func-*.php' same as above but for files with a prefix
        // '[!_]*.php' php files in defined »path«, not beginning with »_« 
        'pattern' => '{*/,}[!_]*.php',
        // optional, defaults to 0
        // needed if for example brackets are used
        // more information: http://www.php.net/manual/en/function.glob.php
        'flags' => GLOB_BRACE
    );
// create object
$functionsfileloader = new Functions_File_Loader( $parameter );
// load the files
foreach ( $functionsfileloader as $file ) {
    $functionsfileloader->load_file( $file );
}
By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.