PSR-1 2.3副作用規則示例

Question

繼此從other question。

在PSR-1 Guidelines，部分2.3副作用規則限制使用include並在同一文件中聲明的功能，例如：

<?php 
// side effect: loads a file 
include "file.php"; 

// declaration 
function foo() 
{ 
    // function body 
} 

但是你可以一個include函數內部文件？

例如

<?php 
// declaration 
function foo() 
{ 
    // side effect: loads a file 
    include "file.php"; 
} 

Answer 1

瞭解有關此規則的事情是聲明和執行之間的差異。您也可以考慮將其作爲加載的代碼與執行的代碼。當你加載的代碼，你不會期望它做任何東西只是尚未。例如：

require_once 'utility_functions.php'; 

包含此文件是因爲要使用該文件中的某個實用程序函數。您需要需要包含此文件以使用其中的任何功能，您不能包含該文件。但是，如果該文件關閉併產生一些副作用，只需將其包括在內，就會進入深處的兔子洞。例如，說文件總是改變你的錯誤報告設置。這將是非常煩人的。每當您包含此文件時，您都必須重置錯誤報告：

require_once 'utility_functions.php'; 
error_reporting(E_ALL); 
ini_set('error_display', false); 

這顯然是瘋狂和潛在問題的根源。

另一方面，一旦你執行代碼，你期望代碼執行某事，甚至可能有副作用。你可以用控制代碼執行，不像文件只是被包含在內。

require_once 'utility_functions.php'; 

utility_do_something(); // side effects here are OK and/or expected