摘要:制定的規(guī)范,簡稱,是開發(fā)的事實標準。原本有四個規(guī)范,分別是自動加載基本代碼規(guī)范代碼樣式日志接口年底,新出了第個規(guī)范。區(qū)別在于的規(guī)范比較干凈,去除了兼容以前版本的內(nèi)容,有一點升級版的感覺。
FIG制定的PHP規(guī)范,簡稱PSR,是PHP開發(fā)的事實標準。
PSR原本有四個規(guī)范,分別是:
PSR-0 自動加載
PSR-1 基本代碼規(guī)范
PSR-2 代碼樣式
PSR-3 日志接口
2013年底,新出了第5個規(guī)范——PSR-4。
PSR-4規(guī)范了如何指定文件路徑從而自動加載類定義,同時規(guī)范了自動加載文件的位置。這個乍一看和PSR-0重復了,實際上,在功能上確實有所重復。區(qū)別在于PSR-4的規(guī)范比較干凈,去除了兼容PHP 5.3以前版本的內(nèi)容,有一點PSR-0升級版的感覺。當然,PSR-4也不是要完全替代PSR-0,而是在必要的時候補充PSR-0——當然,如果你愿意,PSR-4也可以替代PSR-0。PSR-4可以和包括PSR-0在內(nèi)的其他自動加載機制共同使用。
PSR-4和PSR-0最大的區(qū)別是對下劃線(underscore)的定義不同。PSR-4中,在類名中使用下劃線沒有任何特殊含義。而PSR-0則規(guī)定類名中的下劃線_會被轉(zhuǎn)化成目錄分隔符。
代碼樣例以下代碼展示了遵循PSR-4的類定義,這個類處理多個命名空間:
register(); * * // register the base directories for the namespace prefix * $loader->addNamespace("FooBar", "/path/to/packages/foo-bar/src"); * $loader->addNamespace("FooBar", "/path/to/packages/foo-bar/tests"); * * The following line would cause the autoloader to attempt to load the * FooBarQuxQuux class from /path/to/packages/foo-bar/src/Qux/Quux.php: * * prefixes[$prefix]) === false) { $this->prefixes[$prefix] = array(); } // retain the base directory for the namespace prefix if ($prepend) { array_unshift($this->prefixes[$prefix], $base_dir); } else { array_push($this->prefixes[$prefix], $base_dir); } } /** * Loads the class file for a given class name. * * @param string $class The fully-qualified class name. * @return mixed The mapped file name on success, or boolean false on * failure. */ public function loadClass($class) { // the current namespace prefix $prefix = $class; // work backwards through the namespace names of the fully-qualified // class name to find a mapped file name while (false !== $pos = strrpos($prefix, "")) { // retain the trailing namespace separator in the prefix $prefix = substr($class, 0, $pos + 1); // the rest is the relative class name $relative_class = substr($class, $pos + 1); // try to load a mapped file for the prefix and relative class $mapped_file = $this->loadMappedFile($prefix, $relative_class); if ($mapped_file) { return $mapped_file; } // remove the trailing namespace separator for the next iteration // of strrpos() $prefix = rtrim($prefix, ""); } // never found a mapped file return false; } /** * Load the mapped file for a namespace prefix and relative class. * * @param string $prefix The namespace prefix. * @param string $relative_class The relative class name. * @return mixed Boolean false if no mapped file can be loaded, or the * name of the mapped file that was loaded. */ protected function loadMappedFile($prefix, $relative_class) { // are there any base directories for this namespace prefix? if (isset($this->prefixes[$prefix]) === false) { return false; } // look through base directories for this namespace prefix foreach ($this->prefixes[$prefix] as $base_dir) { // replace the namespace prefix with the base directory, // replace namespace separators with directory separators // in the relative class name, append with .php $file = $base_dir . str_replace("", DIRECTORY_SEPARATOR, $relative_class) . ".php"; $file = $base_dir . str_replace("", "/", $relative_class) . ".php"; // if the mapped file exists, require it if ($this->requireFile($file)) { // yes, we"re done return $file; } } // never found it return false; } /** * If a file exists, require it from the file system. * * @param string $file The file to require. * @return bool True if the file exists, false if not. */ protected function requireFile($file) { if (file_exists($file)) { require $file; return true; } return false; } }
相應的單元測試代碼
files = $files; } protected function requireFile($file) { return in_array($file, $this->files); } } class Psr4AutoloaderClassTest extends PHPUnit_Framework_TestCase { protected $loader; protected function setUp() { $this->loader = new MockPsr4AutoloaderClass; $this->loader->setFiles(array( "/vendor/foo.bar/src/ClassName.php", "/vendor/foo.bar/src/DoomClassName.php", "/vendor/foo.bar/tests/ClassNameTest.php", "/vendor/foo.bardoom/src/ClassName.php", "/vendor/foo.bar.baz.dib/src/ClassName.php", "/vendor/foo.bar.baz.dib.zim.gir/src/ClassName.php", )); $this->loader->addNamespace( "FooBar", "/vendor/foo.bar/src" ); $this->loader->addNamespace( "FooBar", "/vendor/foo.bar/tests" ); $this->loader->addNamespace( "FooBarDoom", "/vendor/foo.bardoom/src" ); $this->loader->addNamespace( "FooBarBazDib", "/vendor/foo.bar.baz.dib/src" ); $this->loader->addNamespace( "FooBarBazDibimGir", "/vendor/foo.bar.baz.dib.zim.gir/src" ); } public function testExistingFile() { $actual = $this->loader->loadClass("FooBarClassName"); $expect = "/vendor/foo.bar/src/ClassName.php"; $this->assertSame($expect, $actual); $actual = $this->loader->loadClass("FooBarClassNameTest"); $expect = "/vendor/foo.bar/tests/ClassNameTest.php"; $this->assertSame($expect, $actual); } public function testMissingFile() { $actual = $this->loader->loadClass("No_VendorNo_PackageNoClass"); $this->assertFalse($actual); } public function testDeepFile() { $actual = $this->loader->loadClass("FooBarBazDibimGirClassName"); $expect = "/vendor/foo.bar.baz.dib.zim.gir/src/ClassName.php"; $this->assertSame($expect, $actual); } public function testConfusion() { $actual = $this->loader->loadClass("FooBarDoomClassName"); $expect = "/vendor/foo.bar/src/DoomClassName.php"; $this->assertSame($expect, $actual); $actual = $this->loader->loadClass("FooBarDoomClassName"); $expect = "/vendor/foo.bardoom/src/ClassName.php"; $this->assertSame($expect, $actual); } }Composer
PHP的包管理系統(tǒng)Composer已經(jīng)支持PSR-4,同時也允許在composer.json中定義不同的prefix使用不同的自動加載機制。
Composer使用PSR-0風格
vendor/ vendor_name/ package_name/ src/ Vendor_Name/ Package_Name/ ClassName.php # Vendor_NamePackage_NameClassName tests/ Vendor_Name/ Package_Name/ ClassNameTest.php # Vendor_NamePackage_NameClassName
Composer使用PSR-4風格
vendor/ vendor_name/ package_name/ src/ ClassName.php # Vendor_NamePackage_NameClassName tests/ ClassNameTest.php # Vendor_NamePackage_NameClassNameTest
對比以上兩種結(jié)構(gòu),明顯可以看出PSR-4帶來更簡潔的文件結(jié)構(gòu)。
撰文 SegmentFault
文章版權(quán)歸作者所有,未經(jīng)允許請勿轉(zhuǎn)載,若此文章存在違規(guī)行為,您可以聯(lián)系管理員刪除。
轉(zhuǎn)載請注明本文地址:http://systransis.cn/yun/20643.html
摘要:前言在開始之前,歡迎關(guān)注我自己的博客這篇文章是對自動加載功能的一個總結(jié),內(nèi)容涉及的自動加載功能的命名空間的與標準等內(nèi)容。要實現(xiàn)第一步,第二步的功能,必須在開發(fā)時約定類名與磁盤文件的映射方法,只有這樣我們才能根據(jù)類名找到它對應的磁盤文件。 前言 在開始之前,歡迎關(guān)注我自己的博客:www.leoyang90.cn 這篇文章是對PHP自動加載功能的一個總結(jié),內(nèi)容涉及PHP的自動加載功能、P...
摘要:標準規(guī)范簡介是的簡寫,由組織制定的規(guī)范,是開發(fā)的實踐標準。具體標準有有了統(tǒng)一編碼風格規(guī)范,更有利于查看和學習各個框架或類庫,不不需要每次都適應新的編碼風格。同時在開發(fā)團隊內(nèi)部使用統(tǒng)一的編碼規(guī)范更有利于代碼審查版本控制團隊內(nèi)部交流。 PHP 標準規(guī)范 PSR PSR 簡介 PSR 是 PHP Standard Recommendations 的簡寫,由 PHP FIG 組織制定的 PHP...
摘要:是一系列關(guān)于開發(fā)的規(guī)范,分有好幾個版本,自己學的也較為膚淺,但還是希望能時常查看規(guī)范,為了方便記憶和遵循,我把關(guān)鍵詞為必須的撿拾出來,做個簡單地必要規(guī)范的記錄。所有文件必須使用作為行的結(jié)束符。 PSR是一系列關(guān)于PHP開發(fā)的規(guī)范,分有好幾個版本,自己學的也較為膚淺,但還是希望能時常查看規(guī)范,為了方便記憶和遵循,我把關(guān)鍵詞為必須的撿拾出來,做個簡單地必要規(guī)范的記錄。(就是個搬磚的。。。)...
摘要:公認規(guī)范總結(jié)規(guī)范中文版大部分來源翻譯部分包含例子,附錄包含了一些規(guī)范的實現(xiàn)基本編碼標準編碼風格指南日志接口規(guī)范自動加載規(guī)范規(guī)范英文版未使用草案已棄用規(guī)范原理實現(xiàn)實現(xiàn)自動加載實現(xiàn)原理資料來源與參考 PSR公認規(guī)范總結(jié) PSR規(guī)范中文版(大部分來源google翻譯)(cn) 部分psr包含例子,附錄包含了一些規(guī)范的實現(xiàn) PSR-1:基本編碼標準 PSR-2:編碼風格指南 PSR-3:日志...
摘要:注本文算是筆者對規(guī)范翻譯學習筆記,之后會陸續(xù)翻譯剩余的規(guī)范,可能翻譯的有錯誤的地方,希望讀者能夠指正,非常感謝什么是是標準建議的簡寫,是由組織框架交互操作組織提出。的工作是尋找項目之間的共性,以及讓開發(fā)者能更好協(xié)同工作的方式。 注:本文算是筆者對PSR規(guī)范翻譯/學習筆記,之后會陸續(xù)翻譯剩余的規(guī)范,可能翻譯的有錯誤的地方,希望讀者能夠指正,非常感謝. 什么是PSR? ? ??? PSR是...
閱讀 3488·2021-11-08 13:30
閱讀 3592·2019-08-30 15:55
閱讀 701·2019-08-29 15:16
閱讀 1759·2019-08-26 13:57
閱讀 2109·2019-08-26 12:18
閱讀 805·2019-08-26 11:36
閱讀 1746·2019-08-26 11:30
閱讀 3052·2019-08-23 16:46