本文示例代码测试环境是Windows下的APMServ(PHP5.2.6)

简述

可能大家都知道,php中有一个函数叫debug_backtrace,它可以回溯跟踪函数的调用信息,可以说是一个调试利器。

好,来复习一下。

one();function one() {two();
}function two() {three();
}function three() {print_r( debug_backtrace() );
}/*
输出:
Array
([0] => Array([file] => D:\apmserv\www\htdocs\test\debug\index.php[line] => 10[function] => three[args] => Array())[1] => Array([file] => D:\apmserv\www\htdocs\test\debug\index.php[line] => 6[function] => two[args] => Array())[2] => Array([file] => D:\apmserv\www\htdocs\test\debug\index.php[line] => 3[function] => one[args] => Array()))
*/

顺便提一下类似的函数:debug_print_backtrace,与之不同的是它会直接打印回溯信息。

回来看debug_backtrace,从名字来看用途很明确,是让开发者用来调试的。直到有一天我注意到它返回的file参数,file表示函数或者方法的调用脚本来源(在哪个脚本文件使用的)。忽然我想到,如果当前脚本知道调用来源,那是否可以根据这个来源的不同,来实现一些有趣的功能,比如文件权限管理、动态加载等。

实战

实现魔术函数

获取当前函数或方法的名称

尽管PHP中已经有了__FUNCTION____METHOD__魔术常量,但我还是想介绍一下用debug_backtrace获取当前函数或者方法名称的方法。

代码如下:

//函数外部输出getFuncName的值
echo getFuncName();printFuncName();Object::printMethodName();//调用了上面两个函数后,再次在外部输出getFuncName,看看是否有‘缓存’之类的问题
echo getFuncName();function printFuncName() {echo getFuncName();
}class Object {static function printMethodName() {echo getFuncName();}
}/*** 获取当前函数或者方法的名称* 函数名叫getFuncName,好吧,其实method也可以当做function,实在想不出好名字* * @return string name*/
function getFuncName() {$debug_backtrace = debug_backtrace();//如果函数名是以下几个,表示载入了脚本,并在函数外部调用了getFuncName//这种情况应该返回空$ignore = array('include','include_once','require','require_once');//第一个backtrace就是当前函数getFuncName,再上一个(第二个)backtrace就是调用getFuncName的函数了$handle_func = $debug_backtrace[1];if( isset( $handle_func['function'] ) && !in_array( $handle_func['function'], $ignore ) ) {return $handle_func['function'];}return null;
}//输出:
//null
//printFuncName
//printMethodName
//null

看上去没有问题,很好。

加载相对路径文件

如果在项目中要加载相对路径的文件,必需使用include或者require之类的原生方法,但现在有了debug_backtrace,我可以使用自定义函数去加载相对路径文件。

新建一个项目,目录结构如下:

我想在index.php中调用自定义函数,并使用相对路径去载入package/package.php,并且在package.php中使用同样的方法载入_inc_func.php 

三个文件的代码如下(留意index.phppackage.php调用import函数的代码):

index.php:

<?phpimport( './package/package.php' );/*** 加载当前项目下的文件* * @param string $path 相对文件路径*/
function import( $path ) {//获得backstrace列表$debug_backtrace = debug_backtrace();//第一个backstrace就是调用import的来源脚本$source = $debug_backtrace[0];//得到调用源的目录路径,和文件路径结合,就可以算出完整路径$source_dir = dirname( $source['file'] );require realpath( $source_dir . '/' . $path );
}?>

package.php:

<?phpecho 'package';import( './_inc_func.php' );?>

_inc_func.php:

<?phpecho '_inc_func';?>

运行index.php

//输出:
//package
//_inc_func

可以看到,我成功了。

思考:这个方法我觉得非常强大,除了相对路径之外,可以根据这个思路引伸出相对包、相对模块之类的抽象特性,对于一些项目来说可以增强模块化的作用。

管理文件调用权限

我约定一个规范:文件名前带下划线的只能被当前目录的文件调用,也就是说这种文件属于当前目录‘私有’,其它目录的文件不允许载入它们。

这样做的目的很明确:为了降低代码耦合性。在项目中,很多时候一些文件只被用在特定的脚本中。但是经常发生的事情是:一些程序员发现这些脚本有自己需要用到的函数或者类,因此直接载入它来达到自己的目的。这样的做法很不好,原本这些脚本编写的目的仅仅为了辅助某些接口实现,它们并没有考虑到其它通用性。万一接口内部需要重构,同样需要改动这些特定的脚本文件,但是改动后一些看似与这个接口无关脚本却突然无法运行了。一经检查,却发现文件的引用错综复杂。

规范只是监督作用,不排除有人为了一己私欲而违反这个规范,或者无意中违反了。最好的方法是落实到代码中,让程序自动去检测这种情况。

新建一个项目,目录结构如下。

那么对于这个项目来说,_inc_func.php属于package目录的私有文件,只有package.php可以载入它,而index.php则没有这个权限。

package目录是一个包,package.php下提供了这个包的接口,同时_inc_func.phppackage.php需要用到的一些函数。index.php将会使用这个包的接口文件,也就是package.php

它们的代码如下

index.php:

<?phpheader("Content-type: text/html; charset=utf-8");//定义项目根目录
define( 'APP_PATH', dirname( __FILE__ ) );import( APP_PATH . '/package/package.php' );
//输出包的信息
Package_printInfo();/*** 加载当前项目下的文件* * @param string $path 文件路径*/
function import( $path ) {//应该检查路径的合法性$real_path = realpath( $path );$in_app = ( stripos( $real_path, APP_PATH ) === 0 );if( empty( $real_path ) || !$in_app ) {throw new Exception( '文件路径不存在或不被允许' );}include $real_path;
}?>

_inc_func.php:

<?phpfunction _Package_PrintStr( $string ) {echo $string;
}?>

package.php:

<?phpdefine( 'PACKAGE_PATH', dirname( __FILE__ ) );//引入私有文件
import( PACKAGE_PATH . '/_inc_func.php' );function Package_printInfo() {_Package_PrintStr( '我是一个包。' );
}?>

运行index.php:

//输出:
//我是一个包。

整个项目使用了import函数载入文件,并且代码看起来是正常的。但是我可以在index.php中载入package/_inc_func.php文件,并调用它的方法。

index.php中更改import( APP_PATH . '/package/package.php' );处的代码,并运行:

import( APP_PATH . '/package/_inc_func.php' );_Package_PrintStr( '我载入了/package/_inc_func.php脚本' );//输出:
//我载入了/package/_inc_func.php脚本

那么,这时可以使用debug_backtrace检查载入_inc_func.php文件的路径来自哪里,我改动了index.php中的import函数,完整代码如下:

/*** 加载当前项目下的文件* * @param string $path 文件路径*/
function import( $path ) {//首先应该检查路径的合法性$real_path = realpath( $path );$in_app = ( stripos( $real_path, APP_PATH ) === 0 );if( empty( $real_path ) || !$in_app ) {throw new Exception( '文件路径不存在或不被允许' );}$path_info = pathinfo( $real_path );//判断文件是否属于私有$is_private = ( substr( $path_info['basename'], 0, 1 ) === '_' );if( $is_private ) {//获得backstrace列表$debug_backtrace = debug_backtrace();//第一个backstrace就是调用import的来源脚本$source = $debug_backtrace[0];//得到调用源路径,用它来和目标路径进行比较$source_dir = dirname( $source['file'] );$target_dir = $path_info['dirname'];//不在同一目录下时抛出异常if( $source_dir !== $target_dir ) {$relative_source_file = str_replace( APP_PATH, '', $source['file'] );$relative_target_file = str_replace( APP_PATH, '', $real_path );$error = $relative_target_file . '文件属于私有文件,' . $relative_source_file . '不能载入它。';throw new Exception( $error );}}include $real_path;
}

这时再运行index.php,将产生一个致命错误:

//输出:
//致命错误:/package/_inc_func.php文件属于私有文件,/index.php不能载入它。

而载入package.php则没有问题,这里不进行演示。

可以看到,我当初的想法成功了。尽管这样,在载入package.php后,其实在index.php中仍然还可以调用_inc_func.php的函数(package.php载入了它)。因为除了匿名函数,其它函数是全局可见的,包括类。不过这样或多或少可以让程序员警觉起来。关键还是看程序员本身,再好的规范和约束也抵挡不住烂程序员,他们总是会比你‘聪明’。

debug_backtrace的'BUG'

如果使用call_user_func或者call_user_func_array调用其它函数,它们调用的函数里面使用debug_backtrace,将获取不到路径的信息。

例:

call_user_func('import');function import() {print_r( debug_backtrace() );
}/*
输出:
Array
([0] => Array([function] => import[args] => Array())[1] => Array([file] => F:\www\test\test\index.php[line] => 3[function] => call_user_func[args] => Array([0] => import)))
*/

注意输出的第一个backtrace,它的调用源路径file没有了,这样一来我之前的几个例子将会产生问题。当然可能你注意到第二个backtrace,如果第一个没有就往回找。但经过实践是不可行的,之前我就碰到这种情况,同样会有问题,但是现在无法找回那时的代码了,如果你发现,请将问题告诉我。就目前来说,最好不要使用这种方法,我有一个更好的解决办法,就是使用PHP的反射API。

使用反射

使用反射API可以知道函数很详细的信息,当然包括它声明的文件和所处行数

call_user_func('import');function import() {$debug_backtrace = debug_backtrace();$backtrace = $debug_backtrace[0];if( !isset( $backtrace['file'] ) ) {//使用反射API获取函数声明的文件和行数$reflection_function = new ReflectionFunction( $backtrace['function'] );$backtrace['file'] = $reflection_function->getFileName();$backtrace['line'] = $reflection_function->getStartLine();}print_r($backtrace);
}/*
输出:
Array
([function] => import[args] => Array()[file] => F:\www\test\test\index.php[line] => 5
)
*/

可以看到通过使用反射接口ReflectionMethod的方法file又回来了。

类方法的反射接口是ReflectionMethod,获取声明方法同样是getFileName

总结

在一个项目中,我通常不会直接使用include或者require载入脚本。我喜欢把它们封装到一个函数里,需要载入脚本的时候调用这个函数。这样可以在函数里做一些判断,比如说是否引入过这个文件,或者增加一些调用规则等,维护起来比较方便。

幸好有了这样的习惯,所以我可以马上把debug_backtrace的一些想法应用到整个项目中。

总体来说debug_backtrace有很好的灵活性,只要稍加利用,可以实现一些有趣的功能。但同时我发现它并不是很好控制,因为每次调用任何一个方法或函数,都有可能改变它的值。如果要使用它来做一些逻辑处理(比如说我本文提到的一些想法),需要一个拥有良好规范准则的系统,至少在加载文件方面吧。

转载于:https://www.cnblogs.com/melonblog/archive/2013/05/09/3062303.html

PHP debug_backtrace的胡思乱想相关推荐

  1. [PHP] debug_backtrace()可以获取到代码的调用路径追踪

    查看代码的时候,看到有使用这个函数,测试一下 1.debug_backtrace()可以获取到代码的调用追踪,以数组形式返回 2.debug_print_backtrace() - 打印一条回溯,直接 ...

  2. php执行跟踪_PHP使用debug_backtrace方法跟踪调试代码调用详解

    本文实例讲述了PHP使用debug_backtrace方法跟踪调试代码调用.分享给大家供大家参考,具体如下: 在开发过程中,例如要修改别人开发的代码或调试出问题的代码,需要对代码流程一步步去跟踪,找到 ...

  3. php 利用debug_backtrace方法跟踪代码调用

    在开发过程中,例如要修改别人开发的代码或调试出问题的代码,需要对代码流程一步步去跟踪,找到出问题的地方进行修改.如果有一个方法可以获取到某段代码是被哪个方法调用,并能一直回溯到最开始调用的地方(包括调 ...

  4. PHP错误处理 - debug_backtrace()的用法

    #开发过程中,修改代码或者调试代码,想知道问题出现在哪里,往往是一步步的去排除问题.利用debug_backtrace整个过程的调用过程,并能回溯到最开始调用的地方,便于开发和排查. #说明:debu ...

  5. php debug_print_backtrace,php中debug_backtrace、debug_print_backtrace和匿名函数用法实例

    本文实例讲述了php中debug_backtrace.debug_print_backtrace和匿名函数用法.分享给大家供大家参考.具体分析如下: debug_print_backtrace() 是 ...

  6. php如何跟踪调试,PHP使用debug_backtrace方法跟踪调试代码调用详解

    本文实例讲述了PHP使用debug_backtrace方法跟踪调试代码调用.分享给大家供大家参考,具体如下: 在开发过程中,例如要修改别人开发的代码或调试出问题的代码,需要对代码流程一步步去跟踪,找到 ...

  7. php log 行号 debug_backtrace,PHP debug_backtrace() 函数生成 backtrace(回溯跟踪)

    debug_backtrace() 函数生成 backtrace(回溯跟踪). 该函数显示由 debug_backtrace() 函数代码生成的数据. 返回一个关联数组.可能返回的元素如下: 返回一个 ...

  8. PHP debug_backtrace() 函数

    PHP Error 和 Logging 函数 实例 生成 PHP backtrace: <?phpfunction a($txt) {b("Glenn");}function ...

  9. php log 行号 debug_backtrace,PHP 基于debug_backtrace的流程日志与日志分析

    #PHP 基于debug_backtrace的流程日志与日志分析# 我们都知道php测试性能有一个叫xhprof的(不知道也没事儿的确挺消耗性能的),执行后能看到全部函数的调用关系图,但是我压根不知道 ...

最新文章

  1. 空间复杂度分段分段有序数组合并成有序(空间复杂度为O(1))
  2. 京东B2B业务架构演变阅读心得
  3. 【转】ABP源码分析十三:缓存Cache实现
  4. 【LightOJ - 1030】Discovering Gold(概率dp,数学期望,期望的线性性)
  5. Canvas-drawImage 绘制图片模糊问题
  6. pymongo简单操作
  7. redis使用sysc超时_优雅的处理Redis访问超时
  8. go test生成html测试报告
  9. Android 如何创建项目
  10. Java大数运算(BigInteger BigDecimal)
  11. RESTFul API
  12. Adobe PhotoShop V8.0
  13. 高中数学一轮复习逆袭必要学习方法
  14. JSON校验和JSON在线编辑器
  15. 407. 接雨水 II【我亦无他唯手熟尔】
  16. 7-13 寻找大富翁 (25分)
  17. 功能性和非功能性需求 UP中FURPS+模型需求分类方式
  18. QT ui添加菜单栏和工具栏
  19. 渗透测试-干货 | 80篇+网络安全面试经验帖(面试篇)
  20. C Prime Plus 第二章 C语言概述

热门文章

  1. Tomcat如何修改端口
  2. python强制退出进程时或是异常错误时强制执行某代码:退出处理器
  3. 颗粒化处理图片,科技感十足(当下最流行的图片处理方式之一)
  4. 【建模】次世代游戏建模需要哪些美术功底?
  5. PoE工作原理之PD检测[二]
  6. 0基础学习数据结构(0绪论)
  7. AI深度伪造视频,你能认出来吗?
  8. 平面上的点——Point类
  9. 双12软件促销,Melodyne,Fabfilter,NUGEN Audio,SLATE DIGITAL,Prime Studio,McDSP
  10. 符号服务器 作用,[原创]搭建自己的符号服务器(一)——啰嗦篇