PHP命名空間與自動加載機制的基礎(chǔ)介紹

更新時間：2019年08月25日 14:15:43 作者：woider

這篇文章主要給大家介紹了關(guān)于PHP命名空間與自動加載機制的相關(guān)資料，文中通過示例代碼介紹的非常詳細(xì)，對大家學(xué)習(xí)或者使用PHP具有一定的參考學(xué)習(xí)價值，需要的朋友們下面來一起學(xué)習(xí)學(xué)習(xí)吧

前言

include 和 require 是PHP中引入文件的兩個基本方法。在小規(guī)模開發(fā)中直接使用 include 和 require 沒喲什么不妥，但在大型項目中會造成大量的 include 和 require 堆積。這樣的代碼既不優(yōu)雅，執(zhí)行效率也很低，而且維護起來也相當(dāng)困難。

為了解決這個問題，部分框架會給出一個引入文件的配置清單，在對象初始化的時候把需要的文件引入。但這只是讓代碼變得更簡潔了一些，引入的效果仍然是差強人意。PHP5 之后，隨著 PHP 面向?qū)ο笾С值耐晟?，__autoload 函數(shù)才真正使得自動加載成為可能。

* include 和 require 功能是一樣的，它們的不同在于 include 出錯時只會產(chǎn)生警告，而 require 會拋出錯誤終止腳本。

* include_once 和 include 唯一的區(qū)別在于 include_once 會檢查文件是否已經(jīng)引入，如果是則不會重復(fù)引入。

=================自動加載==================

實現(xiàn)自動加載最簡單的方式就是使用 __autoload 魔術(shù)方法。當(dāng)需要使用的類沒有被引入時，這個函數(shù)會在PHP報錯前被觸發(fā)，未定義的類名會被當(dāng)作參數(shù)傳入。至于函數(shù)具體的邏輯，這需要用戶自己去實現(xiàn)。

首先創(chuàng)建一個 autoload.php 來做一個簡單的測試：

// 類未定義時，系統(tǒng)自動調(diào)用
function __autoload($class)
{
 /* 具體處理邏輯 */
 echo $class;// 簡單的輸出未定義的類名
}

new HelloWorld();

/**
 * 輸出 HelloWorld 與報錯信息
 * Fatal error: Class 'HelloWorld' not found
 */

通過這個簡單的例子可以發(fā)現(xiàn)，在類的實例化過程中，系統(tǒng)所做的工作大致是這樣的：

/* 模擬系統(tǒng)實例化過程 */
function instance($class)
{
 // 如果類存在則返回其實例
 if (class_exists($class, false)) {
  return new $class();
 }
 // 查看 autoload 函數(shù)是否被用戶定義
 if (function_exists('__autoload')) {
  __autoload($class); // 最后一次引入的機會
 }
 // 再次檢查類是否存在
 if (class_exists($class, false)) {
  return new $class();
 } else { // 系統(tǒng)：我實在沒轍了
  throw new Exception('Class Not Found');
 }
}

明白了 __autoload 函數(shù)的工作原理之后，那就讓我們來用它去實現(xiàn)自動加載。

首先創(chuàng)建一個類文件（建議文件名與類名一致），代碼如下：

class [ClassName] 
{
 // 對象實例化時輸出當(dāng)前類名
 function __construct()
 {
  echo '<h1>' . __CLASS__ . '</h1>';
 }
}

（我這里創(chuàng)建了一個 HelloWorld 類用作演示）接下來我們就要定義 __autoload 的具體邏輯，使它能夠?qū)崿F(xiàn)自動加載：

function __autoload($class)
{
 // 根據(jù)類名確定文件名
 $file = $class . '.php';

 if (file_exists($file)) {
  include $file; // 引入PHP文件
 }
}

new HelloWorld();

/**
 * 輸出 <h1>HelloWorld</h1>
 */

=================命名空間==================

其實命名空間并不是什么新生事物，很多語言（例如C++）早都支持這個特性了。只不過 PHP 起步比較晚，直到 PHP 5.3 之后才支持。

命名空間簡而言之就是一種標(biāo)識，它的主要目的是解決命名沖突的問題。

就像在日常生活中，有很多姓名相同的人，如何區(qū)分這些人呢？那就需要加上一些額外的標(biāo)識。

把工作單位當(dāng)成標(biāo)識似乎不錯，這樣就不用擔(dān)心 “撞名” 的尷尬了。

這里我們來做一個小任務(wù)，去介紹百度的CEO李彥宏：

namespace 百度;

class 李彥宏
{
 function __construct()
 {
  echo '百度創(chuàng)始人';
 }
}

↑ 這就是李彥宏的基本資料了，namespace 是他的單位標(biāo)識，class 是他的姓名。

命名空間通過關(guān)鍵字 namespace 來聲明。如果一個文件中包含命名空間，它必須在其它所有代碼之前聲明命名空間。

new 百度\李彥宏(); // 限定類名
new \百度\李彥宏(); // 完全限定類名

↑ 在一般情況下，無論是向別人介紹 "百度李彥宏" 還是 "百度公司李彥宏"，他們都能夠明白。

在當(dāng)前命名空間沒有聲明的情況下，限定類名和完全限定類名是等價的。因為如果不指定空間，則默認(rèn)為全局（\）。

namespace 谷歌;

new 百度\李彥宏(); // 谷歌\百度\李彥宏（實際結(jié)果）
new \百度\李彥宏(); // 百度\李彥宏（實際結(jié)果）

↑ 如果你在谷歌公司向他們的員工介紹李彥宏，一定要指明是 "百度公司的李彥宏"。否則他會認(rèn)為百度是谷歌的一個部門，而李彥宏只是其中的一位員工而已。

這個例子展示了在命名空間下，使用限定類名和完全限定類名的區(qū)別。（完全限定類名 = 當(dāng)前命名空間 + 限定類名）

/* 導(dǎo)入命名空間 */
use 百度\李彥宏;
new 李彥宏(); // 百度\李彥宏（實際結(jié)果）

/* 設(shè)置別名 */
use 百度\李彥宏 AS CEO;
new CEO(); // 百度\李彥宏（實際結(jié)果）

/* 任何情況 */
new \百度\李彥宏();// 百度\李彥宏（實際結(jié)果）

↑ 第一種情況是別人已經(jīng)認(rèn)識李彥宏了，你只需要直接說名字，他就能知道你指的是誰。第二種情況是李彥宏就是他們的CEO，你直接說CEO，他可以立刻反應(yīng)過來。

使用命名空間只是讓類名有了前綴，不容易發(fā)生沖突，系統(tǒng)仍然不會進行自動導(dǎo)入。

如果不引入文件，系統(tǒng)會在拋出 "Class Not Found" 錯誤之前觸發(fā) __autoload 函數(shù)，并將限定類名傳入作為參數(shù)。

所以上面的例子都是基于你已經(jīng)將相關(guān)文件手動引入的情況下實現(xiàn)的，否則系統(tǒng)會拋出 " Class '百度\李彥宏' not found"。

=================spl_autoload==================

接下來讓我們要在含有命名空間的情況下去實現(xiàn)自動加載。這里我們使用 spl_autoload_register() 函數(shù)來實現(xiàn)，這需要你的 PHP 版本號大于 5.12。

spl_autoload_register 函數(shù)的功能就是把傳入的函數(shù)（參數(shù)可以為回調(diào)函數(shù)或函數(shù)名稱形式）注冊到 SPL __autoload 函數(shù)隊列中，并移除系統(tǒng)默認(rèn)的 __autoload() 函數(shù)。

一旦調(diào)用 spl_autoload_register() 函數(shù)，當(dāng)調(diào)用未定義類時，系統(tǒng)就會按順序調(diào)用注冊到 spl_autoload_register() 函數(shù)的所有函數(shù)，而不是自動調(diào)用 __autoload() 函數(shù)。

現(xiàn)在，我們來創(chuàng)建一個 Linux 類，它使用 os 作為它的命名空間（建議文件名與類名保持一致）：

namespace os; // 命名空間

class Linux // 類名
{
 function __construct()
 {
  echo '<h1>' . __CLASS__ . '</h1>';
 }
}

接著，在同一個目錄下新建一個 PHP 文件，使用 spl_autoload_register 以函數(shù)回調(diào)的方式實現(xiàn)自動加載：

spl_autoload_register(function ($class) { // class = os\Linux

 /* 限定類名路徑映射 */
 $class_map = array(
  // 限定類名 => 文件路徑
  'os\\Linux' => './Linux.php',
 );

 /* 根據(jù)類名確定文件名 */
 $file = $class_map[$class];

 /* 引入相關(guān)文件 */
 if (file_exists($file)) {
  include $file;
 }
});

new \os\Linux();

這里我們使用了一個數(shù)組去保存類名與文件路徑的關(guān)系，這樣當(dāng)類名傳入時，自動加載器就知道該引入哪個文件去加載這個類了。

但是一旦文件多起來的話，映射數(shù)組會變得很長，這樣的話維護起來會相當(dāng)麻煩。如果命名能遵守統(tǒng)一的約定，就可以讓自動加載器自動解析判斷類文件所在的路徑。接下來要介紹的PSR-4 就是一種被廣泛采用的約定方式。

=================PSR-4規(guī)范==================

PSR-4 是關(guān)于由文件路徑自動載入對應(yīng)類的相關(guān)規(guī)范，規(guī)范規(guī)定了一個完全限定類名需要具有以下結(jié)構(gòu)：

\<頂級命名空間>(\<子命名空間>)*\<類名>

如果繼續(xù)拿上面的例子打比方的話，頂級命名空間相當(dāng)于公司，子命名空間相當(dāng)于職位，類名相當(dāng)于人名。那么李彥宏標(biāo)準(zhǔn)的稱呼為 "百度公司 CEO 李彥宏"。

PSR-4 規(guī)范中必須要有一個頂級命名空間，它的意義在于表示某一個特殊的目錄（文件基目錄）。子命名空間代表的是類文件相對于文件基目錄的這一段路徑（相對路徑），類名則與文件名保持一致（注意大小寫的區(qū)別）。

舉個例子：在全限定類名 \app\view\news\Index 中，如果 app 代表 C:\Baidu，那么這個類的路徑則是 C:\Baidu\view\news\Index.php

我們就以解析 \app\view\news\Index 為例，編寫一個簡單的 Demo：

$class = 'app\view\news\Index';

/* 頂級命名空間路徑映射 */
$vendor_map = array(
  'app' => 'C:\Baidu',
);

/* 解析類名為文件路徑 */
$vendor = substr($class, 0, strpos($class, '\\')); // 取出頂級命名空間[app]
$vendor_dir = $vendor_map[$vendor]; // 文件基目錄[C:\Baidu]
$rel_path = dirname(substr($class, strlen($vendor))); // 相對路徑[/view/news]
$file_name = basename($class) . '.php'; // 文件名[Index.php]

/* 輸出文件所在路徑 */
echo $vendor_dir . $rel_path . DIRECTORY_SEPARATOR . $file_name;

通過這個 Demo 可以看出限定類名轉(zhuǎn)換為路徑的過程。那么現(xiàn)在就讓我們用規(guī)范的面向?qū)ο蠓绞饺崿F(xiàn)自動加載器吧。

首先我們創(chuàng)建一個文件 Index.php，它處于 \app\mvc\view\home 目錄中：

namespace app\mvc\view\home;

class Index
{
  function __construct()
  {
    echo '<h1> Welcome To Home </h1>';
  }
}

接著我們在創(chuàng)建一個加載類（不需要命名空間），它處于 \ 目錄中：

class Loader
{
  /* 路徑映射 */
  public static $vendorMap = array(
    'app' => __DIR__ . DIRECTORY_SEPARATOR . 'app',
  );

  /**
   * 自動加載器
   */
  public static function autoload($class)
  {
    $file = self::findFile($class);
    if (file_exists($file)) {
      self::includeFile($file);
    }
  }

  /**
   * 解析文件路徑
   */
  private static function findFile($class)
  {
    $vendor = substr($class, 0, strpos($class, '\\')); // 頂級命名空間
    $vendorDir = self::$vendorMap[$vendor]; // 文件基目錄
    $filePath = substr($class, strlen($vendor)) . '.php'; // 文件相對路徑
    return strtr($vendorDir . $filePath, '\\', DIRECTORY_SEPARATOR); // 文件標(biāo)準(zhǔn)路徑
  }

  /**
   * 引入文件
   */
  private static function includeFile($file)
  {
    if (is_file($file)) {
      include $file;
    }
  }
}

最后，將 Loader 類中的 autoload 注冊到 spl_autoload_register 函數(shù)中：

include 'Loader.php'; // 引入加載器
spl_autoload_register('Loader::autoload'); // 注冊自動加載

new \app\mvc\view\home\Index(); // 實例化未引用的類

/**
 * 輸出: <h1> Welcome To Home </h1>
 */

示例中的代碼其實就是 ThinkPHP 自動加載器源碼的精簡版，它是 ThinkPHP 5 能實現(xiàn)惰性加載的關(guān)鍵。

至此，自動加載的原理已經(jīng)全部講完了，如果有興趣深入了解的話，可以參考下面的 ThinkPHP 源碼。

class Loader
{
  protected static $instance = [];
  // 類名映射
  protected static $map = [];

  // 命名空間別名
  protected static $namespaceAlias = [];

  // PSR-4
  private static $prefixLengthsPsr4 = [];
  private static $prefixDirsPsr4  = [];
  private static $fallbackDirsPsr4 = [];

  // PSR-0
  private static $prefixesPsr0   = [];
  private static $fallbackDirsPsr0 = [];

  // 自動加載的文件
  private static $autoloadFiles = [];

  // 自動加載
  public static function autoload($class)
  {
    // 檢測命名空間別名
    if (!empty(self::$namespaceAlias)) {
      $namespace = dirname($class);
      if (isset(self::$namespaceAlias[$namespace])) {
        $original = self::$namespaceAlias[$namespace] . '\\' . basename($class);
        if (class_exists($original)) {
          return class_alias($original, $class, false);
        }
      }
    }

    if ($file = self::findFile($class)) {

      // Win環(huán)境嚴(yán)格區(qū)分大小寫
      if (IS_WIN && pathinfo($file, PATHINFO_FILENAME) != pathinfo(realpath($file), PATHINFO_FILENAME)) {
        return false;
      }

      __include_file($file);
      return true;
    }
  }

  /**
   * 查找文件
   * @param $class
   * @return bool
   */
  private static function findFile($class)
  {
    if (!empty(self::$map[$class])) {
      // 類庫映射
      return self::$map[$class];
    }

    // 查找 PSR-4
    $logicalPathPsr4 = strtr($class, '\\', DS) . EXT;

    $first = $class[0];
    if (isset(self::$prefixLengthsPsr4[$first])) {
      foreach (self::$prefixLengthsPsr4[$first] as $prefix => $length) {
        if (0 === strpos($class, $prefix)) {
          foreach (self::$prefixDirsPsr4[$prefix] as $dir) {
            if (is_file($file = $dir . DS . substr($logicalPathPsr4, $length))) {
              return $file;
            }
          }
        }
      }
    }

    // 查找 PSR-4 fallback dirs
    foreach (self::$fallbackDirsPsr4 as $dir) {
      if (is_file($file = $dir . DS . $logicalPathPsr4)) {
        return $file;
      }
    }

    // 查找 PSR-0
    if (false !== $pos = strrpos($class, '\\')) {
      // namespaced class name
      $logicalPathPsr0 = substr($logicalPathPsr4, 0, $pos + 1)
      . strtr(substr($logicalPathPsr4, $pos + 1), '_', DS);
    } else {
      // PEAR-like class name
      $logicalPathPsr0 = strtr($class, '_', DS) . EXT;
    }

    if (isset(self::$prefixesPsr0[$first])) {
      foreach (self::$prefixesPsr0[$first] as $prefix => $dirs) {
        if (0 === strpos($class, $prefix)) {
          foreach ($dirs as $dir) {
            if (is_file($file = $dir . DS . $logicalPathPsr0)) {
              return $file;
            }
          }
        }
      }
    }

    // 查找 PSR-0 fallback dirs
    foreach (self::$fallbackDirsPsr0 as $dir) {
      if (is_file($file = $dir . DS . $logicalPathPsr0)) {
        return $file;
      }
    }

    return self::$map[$class] = false;
  }

  // 注冊classmap
  public static function addClassMap($class, $map = '')
  {
    if (is_array($class)) {
      self::$map = array_merge(self::$map, $class);
    } else {
      self::$map[$class] = $map;
    }
  }

  // 注冊命名空間
  public static function addNamespace($namespace, $path = '')
  {
    if (is_array($namespace)) {
      foreach ($namespace as $prefix => $paths) {
        self::addPsr4($prefix . '\\', rtrim($paths, DS), true);
      }
    } else {
      self::addPsr4($namespace . '\\', rtrim($path, DS), true);
    }
  }

  // 添加Ps0空間
  private static function addPsr0($prefix, $paths, $prepend = false)
  {
    if (!$prefix) {
      if ($prepend) {
        self::$fallbackDirsPsr0 = array_merge(
          (array) $paths,
          self::$fallbackDirsPsr0
        );
      } else {
        self::$fallbackDirsPsr0 = array_merge(
          self::$fallbackDirsPsr0,
          (array) $paths
        );
      }

      return;
    }

    $first = $prefix[0];
    if (!isset(self::$prefixesPsr0[$first][$prefix])) {
      self::$prefixesPsr0[$first][$prefix] = (array) $paths;

      return;
    }
    if ($prepend) {
      self::$prefixesPsr0[$first][$prefix] = array_merge(
        (array) $paths,
        self::$prefixesPsr0[$first][$prefix]
      );
    } else {
      self::$prefixesPsr0[$first][$prefix] = array_merge(
        self::$prefixesPsr0[$first][$prefix],
        (array) $paths
      );
    }
  }

  // 添加Psr4空間
  private static function addPsr4($prefix, $paths, $prepend = false)
  {
    if (!$prefix) {
      // Register directories for the root namespace.
      if ($prepend) {
        self::$fallbackDirsPsr4 = array_merge(
          (array) $paths,
          self::$fallbackDirsPsr4
        );
      } else {
        self::$fallbackDirsPsr4 = array_merge(
          self::$fallbackDirsPsr4,
          (array) $paths
        );
      }
    } elseif (!isset(self::$prefixDirsPsr4[$prefix])) {
      // Register directories for a new namespace.
      $length = strlen($prefix);
      if ('\\' !== $prefix[$length - 1]) {
        throw new \InvalidArgumentException("A non-empty PSR-4 prefix must end with a namespace separator.");
      }
      self::$prefixLengthsPsr4[$prefix[0]][$prefix] = $length;
      self::$prefixDirsPsr4[$prefix]        = (array) $paths;
    } elseif ($prepend) {
      // Prepend directories for an already registered namespace.
      self::$prefixDirsPsr4[$prefix] = array_merge(
        (array) $paths,
        self::$prefixDirsPsr4[$prefix]
      );
    } else {
      // Append directories for an already registered namespace.
      self::$prefixDirsPsr4[$prefix] = array_merge(
        self::$prefixDirsPsr4[$prefix],
        (array) $paths
      );
    }
  }

  // 注冊命名空間別名
  public static function addNamespaceAlias($namespace, $original = '')
  {
    if (is_array($namespace)) {
      self::$namespaceAlias = array_merge(self::$namespaceAlias, $namespace);
    } else {
      self::$namespaceAlias[$namespace] = $original;
    }
  }

  // 注冊自動加載機制
  public static function register($autoload = '')
  {
    // 注冊系統(tǒng)自動加載
    spl_autoload_register($autoload ?: 'think\\Loader::autoload', true, true);
    // 注冊命名空間定義
    self::addNamespace([
      'think'  => LIB_PATH . 'think' . DS,
      'behavior' => LIB_PATH . 'behavior' . DS,
      'traits'  => LIB_PATH . 'traits' . DS,
    ]);
    // 加載類庫映射文件
    if (is_file(RUNTIME_PATH . 'classmap' . EXT)) {
      self::addClassMap(__include_file(RUNTIME_PATH . 'classmap' . EXT));
    }

    // Composer自動加載支持
    if (is_dir(VENDOR_PATH . 'composer')) {
      self::registerComposerLoader();
    }

    // 自動加載extend目錄
    self::$fallbackDirsPsr4[] = rtrim(EXTEND_PATH, DS);
  }

  // 注冊composer自動加載
  private static function registerComposerLoader()
  {
    if (is_file(VENDOR_PATH . 'composer/autoload_namespaces.php')) {
      $map = require VENDOR_PATH . 'composer/autoload_namespaces.php';
      foreach ($map as $namespace => $path) {
        self::addPsr0($namespace, $path);
      }
    }

    if (is_file(VENDOR_PATH . 'composer/autoload_psr4.php')) {
      $map = require VENDOR_PATH . 'composer/autoload_psr4.php';
      foreach ($map as $namespace => $path) {
        self::addPsr4($namespace, $path);
      }
    }

    if (is_file(VENDOR_PATH . 'composer/autoload_classmap.php')) {
      $classMap = require VENDOR_PATH . 'composer/autoload_classmap.php';
      if ($classMap) {
        self::addClassMap($classMap);
      }
    }

    if (is_file(VENDOR_PATH . 'composer/autoload_files.php')) {
      $includeFiles = require VENDOR_PATH . 'composer/autoload_files.php';
      foreach ($includeFiles as $fileIdentifier => $file) {
        if (empty(self::$autoloadFiles[$fileIdentifier])) {
          __require_file($file);
          self::$autoloadFiles[$fileIdentifier] = true;
        }
      }
    }
  }

  /**
   * 導(dǎo)入所需的類庫 同java的Import 本函數(shù)有緩存功能
   * @param string $class  類庫命名空間字符串
   * @param string $baseUrl 起始路徑
   * @param string $ext   導(dǎo)入的文件擴展名
   * @return boolean
   */
  public static function import($class, $baseUrl = '', $ext = EXT)
  {
    static $_file = [];
    $key     = $class . $baseUrl;
    $class    = str_replace(['.', '#'], [DS, '.'], $class);
    if (isset($_file[$key])) {
      return true;
    }

    if (empty($baseUrl)) {
      list($name, $class) = explode(DS, $class, 2);

      if (isset(self::$prefixDirsPsr4[$name . '\\'])) {
        // 注冊的命名空間
        $baseUrl = self::$prefixDirsPsr4[$name . '\\'];
      } elseif ('@' == $name) {
        //加載當(dāng)前模塊應(yīng)用類庫
        $baseUrl = App::$modulePath;
      } elseif (is_dir(EXTEND_PATH . $name)) {
        $baseUrl = EXTEND_PATH;
      } else {
        // 加載其它模塊的類庫
        $baseUrl = APP_PATH . $name . DS;
      }
    } elseif (substr($baseUrl, -1) != DS) {
      $baseUrl .= DS;
    }
    // 如果類存在 則導(dǎo)入類庫文件
    if (is_array($baseUrl)) {
      foreach ($baseUrl as $path) {
        $filename = $path . DS . $class . $ext;
        if (is_file($filename)) {
          break;
        }
      }
    } else {
      $filename = $baseUrl . $class . $ext;
    }

    if (!empty($filename) && is_file($filename)) {
      // 開啟調(diào)試模式Win環(huán)境嚴(yán)格區(qū)分大小寫
      if (IS_WIN && pathinfo($filename, PATHINFO_FILENAME) != pathinfo(realpath($filename), PATHINFO_FILENAME)) {
        return false;
      }
      __include_file($filename);
      $_file[$key] = true;
      return true;
    }
    return false;
  }

  /**
   * 實例化（分層）模型
   * @param string $name     Model名稱
   * @param string $layer    業(yè)務(wù)層名稱
   * @param bool  $appendSuffix 是否添加類名后綴
   * @param string $common    公共模塊名
   * @return Object
   * @throws ClassNotFoundException
   */
  public static function model($name = '', $layer = 'model', $appendSuffix = false, $common = 'common')
  {
    if (isset(self::$instance[$name . $layer])) {
      return self::$instance[$name . $layer];
    }
    if (strpos($name, '/')) {
      list($module, $name) = explode('/', $name, 2);
    } else {
      $module = Request::instance()->module();
    }
    $class = self::parseClass($module, $layer, $name, $appendSuffix);
    if (class_exists($class)) {
      $model = new $class();
    } else {
      $class = str_replace('\\' . $module . '\\', '\\' . $common . '\\', $class);
      if (class_exists($class)) {
        $model = new $class();
      } else {
        throw new ClassNotFoundException('class not exists:' . $class, $class);
      }
    }
    self::$instance[$name . $layer] = $model;
    return $model;
  }

  /**
   * 實例化（分層）控制器 格式：[模塊名/]控制器名
   * @param string $name     資源地址
   * @param string $layer    控制層名稱
   * @param bool  $appendSuffix 是否添加類名后綴
   * @param string $empty    空控制器名稱
   * @return Object|false
   * @throws ClassNotFoundException
   */
  public static function controller($name, $layer = 'controller', $appendSuffix = false, $empty = '')
  {
    if (strpos($name, '/')) {
      list($module, $name) = explode('/', $name);
    } else {
      $module = Request::instance()->module();
    }
    $class = self::parseClass($module, $layer, $name, $appendSuffix);
    if (class_exists($class)) {
      return new $class(Request::instance());
    } elseif ($empty && class_exists($emptyClass = self::parseClass($module, $layer, $empty, $appendSuffix))) {
      return new $emptyClass(Request::instance());
    }
  }

  /**
   * 實例化驗證類 格式：[模塊名/]驗證器名
   * @param string $name     資源地址
   * @param string $layer    驗證層名稱
   * @param bool  $appendSuffix 是否添加類名后綴
   * @param string $common    公共模塊名
   * @return Object|false
   * @throws ClassNotFoundException
   */
  public static function validate($name = '', $layer = 'validate', $appendSuffix = false, $common = 'common')
  {
    $name = $name ?: Config::get('default_validate');
    if (empty($name)) {
      return new Validate;
    }

    if (isset(self::$instance[$name . $layer])) {
      return self::$instance[$name . $layer];
    }
    if (strpos($name, '/')) {
      list($module, $name) = explode('/', $name);
    } else {
      $module = Request::instance()->module();
    }
    $class = self::parseClass($module, $layer, $name, $appendSuffix);
    if (class_exists($class)) {
      $validate = new $class;
    } else {
      $class = str_replace('\\' . $module . '\\', '\\' . $common . '\\', $class);
      if (class_exists($class)) {
        $validate = new $class;
      } else {
        throw new ClassNotFoundException('class not exists:' . $class, $class);
      }
    }
    self::$instance[$name . $layer] = $validate;
    return $validate;
  }

  /**
   * 數(shù)據(jù)庫初始化 并取得數(shù)據(jù)庫類實例
   * @param mixed     $config 數(shù)據(jù)庫配置
   * @param bool|string  $name 連接標(biāo)識 true 強制重新連接
   * @return \think\db\Connection
   */
  public static function db($config = [], $name = false)
  {
    return Db::connect($config, $name);
  }

  /**
   * 遠(yuǎn)程調(diào)用模塊的操作方法 參數(shù)格式 [模塊/控制器/]操作
   * @param string    $url     調(diào)用地址
   * @param string|array $vars     調(diào)用參數(shù) 支持字符串和數(shù)組
   * @param string    $layer    要調(diào)用的控制層名稱
   * @param bool     $appendSuffix 是否添加類名后綴
   * @return mixed
   */
  public static function action($url, $vars = [], $layer = 'controller', $appendSuffix = false)
  {
    $info  = pathinfo($url);
    $action = $info['basename'];
    $module = '.' != $info['dirname'] ? $info['dirname'] : Request::instance()->controller();
    $class = self::controller($module, $layer, $appendSuffix);
    if ($class) {
      if (is_scalar($vars)) {
        if (strpos($vars, '=')) {
          parse_str($vars, $vars);
        } else {
          $vars = [$vars];
        }
      }
      return App::invokeMethod([$class, $action . Config::get('action_suffix')], $vars);
    }
  }

  /**
   * 字符串命名風(fēng)格轉(zhuǎn)換
   * type 0 將Java風(fēng)格轉(zhuǎn)換為C的風(fēng)格 1 將C風(fēng)格轉(zhuǎn)換為Java的風(fēng)格
   * @param string $name 字符串
   * @param integer $type 轉(zhuǎn)換類型
   * @return string
   */
  public static function parseName($name, $type = 0)
  {
    if ($type) {
      return ucfirst(preg_replace_callback('/_([a-zA-Z])/', function ($match) {
        return strtoupper($match[1]);
      }, $name));
    } else {
      return strtolower(trim(preg_replace("/[A-Z]/", "_\\0", $name), "_"));
    }
  }

  /**
   * 解析應(yīng)用類的類名
   * @param string $module 模塊名
   * @param string $layer 層名 controller model ...
   * @param string $name  類名
   * @param bool  $appendSuffix
   * @return string
   */
  public static function parseClass($module, $layer, $name, $appendSuffix = false)
  {
    $name = str_replace(['/', '.'], '\\', $name);
    $array = explode('\\', $name);
    $class = self::parseName(array_pop($array), 1) . (App::$suffix || $appendSuffix ? ucfirst($layer) : '');
    $path = $array ? implode('\\', $array) . '\\' : '';
    return App::$namespace . '\\' . ($module ? $module . '\\' : '') . $layer . '\\' . $path . $class;
  }

  /**
   * 初始化類的實例
   * @return void
   */
  public static function clearInstance()
  {
    self::$instance = [];
  }
}

/**
 * 作用范圍隔離
 *
 * @param $file
 * @return mixed
 */
function __include_file($file)
{
  return include $file;
}

function __require_file($file)
{
  return require $file;
}

總結(jié)

以上就是這篇文章的全部內(nèi)容了，希望本文的內(nèi)容對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，謝謝大家對腳本之家的支持。

您可能感興趣的文章: