php debug 调试工具

其项目地址: php教程-debug-tools/">http://freshmeat.net/projects/php-debug-tools/
文件下载地址: http://freshmeat.net/urls/7c58ae3fecce5763e7546b958d36e082
目前是1.03版本

这里偶的环境是window xp , apache2.2, php5.2+ zend optimizer,
这里结合php debug tools的帮助文档来讲解,图有些是摘自文档.

一.安装篇
安装前的准备环境:必须得先装x-debug,
至于怎样安装x-debug请看http://www.xdebug.org/docs/install

1. 从http://www.xdebug.org/download.php下载合适你的x-debug版本
2. 解压dll文件到php安装目录下的ext目录,如c:/php/ext/php_xdebug-2.0.4-5.2.8-nts.dll
3. 修改php.ini文件,加入下段:
-------------偶是变态的分割线,你看不见我------------------------
zend_extension = "c:/php/ext/php_xdebug-2.0.4-5.2.8-nts.dll"
xdebug.collect_includes = off
xdebug.default_enable = off

xdebug.dump_globals = off
xdebug.dump_once = off
xdebug.extended_info = off
-------------偶是变态的分割线,你看不见我------------------------
注:this example is for non-thread safe version. for the thread safe version change "zend_extension" to "zend_extension_ts"

安装完毕,解压php debug tools压缩包里的所有文件到网站发布目录.
(假设发布目录为c:www,那么就在其新建一个debug目录,把所有文件扔进去)

在浏览器中输入:http://localhost/debug/test1-debug.php
如果看见下图则安装成功.

二.调试篇
1.debug errors
如以下代码:
复制代码 代码如下:
<?php
require './lib/debug.php';
function test($a, $b)
{
echo $asd;
}
test(10, 'abc');
?>

2.用debug()来调试
如以下代码:
复制代码 代码如下:
<?php
require './lib/debug.php';
function test($args)
{
test_nested($args);
}
function test_nested($args)
{
debug($args);
// or: debug(get_defined_vars());
// or: debug();
}
test(array('id'=>123, 'str'=>'test'));
?>

3.用dump()或者dump_tofile()调试
如以下代码:
复制代码 代码如下:
<?php
include_once './lib/dump.php';
function test5()
{
include './testdata/test0.php';
$test = array('int'=>1, 'float'=>2.0, 'float2'=>2.1);
dump($test, $_server);
}
function test1() { test2(); }
function test2() { test3(); }
function test3() { test4(); }
function test4() { test5(); }
test1();
?>

至于dump_tofile()一般在以下情形使用:
a.当你不想停止程序运行时
b.不是你不想显示调式数据,而是你不能.比如当你在ajax请求状态时.
c.你还想在多处地方调式

可参见debug目录下的test7-dump_tofile.php

注:本人在运行dump()或者dump_tofile()时发现并不能出现php debug tool文档中所述

这里可以通过修改debug/lib/debug.php的代码来更正.(因为dump_tofile()有调用到dump(),所以我们只需修改一处.
于149行处的
echo $pre;

修改成:

//edit by benben---start
echo '<script type="text/网页特效">';
echo 'document.write(';
echo $pre;
echo ');';
echo '</script>';
//edit by benben---end

修正后的图:

4.跟踪代码,查看系统性能
可以浏览目录下的test3-trace.php,之后点右下角的控制台就可以了.
具体可参照文档.(文档在压缩包内的doc目录下)
三,如何与项目结合?

先把php debug tool的解压缩文件,放置于项目目录,建个目录就叫debug吧! : )
其实我们需要的只是几个文件而已.
比如路径为:c:wwwprojectnamedebug

之后,我们可以通过两种方式来调试
第一种,可以在项目源码中加入这么一句:
include_once('./lib/debug.php');

例如以下:c:wwwprojectnamehellodebugindex.php
复制代码 代码如下:
<?php
include_once('./debug/lib/debug.php');

$faint = 'helloworld ,debuging';

debug($arrb);
?>

什么?你不想每个页面都写这么一句?
那么看看第二种方法,
这里也有两种方式,
1.修改php.ini 加入以下内容(修改成你自身的目录):
auto_prepend_file = "c:wwwprojectnamedebugauto_prepend.php"
auto_append_file = "c:wwwprojectnamedebugauto_append.php"

2.修改.htaccess文件(注:此方法偶没试过,嘿嘿)
php_value auto_prepend_file "c:wwwprojectnamedebugauto_prepend.php"
php_value auto_append_file "c:wwwprojectnamedebugauto_append.php"

php教程支持gb2312,uft-8中英文字符截取函数

<?php
//截取gb2312中文字符串
function mysubstr($str, $start, $len) {
    $tmps教程tr = "";
    $strlen = $start + $len;
    for($i = 0; $i < $strlen; $i++) {
        if(ord(substr($str, $i, 1)) > 0xa0) {
            $tmpstr .= substr($str, $i, 2);
            $i++;
        } else
            $tmpstr .= substr($str, $i, 1);
    }
    return $tmpstr;
}
?>

<?php
//截取utf8字符串
function utf8substr($str, $from, $len)
{
    return preg_replace('#^(?:[x00-x7f]|[xc0-xff][x80-xbf]+){0,'.$from.'}'.
                       '((?:[x00-x7f]|[xc0-xff][x80-xbf]+){0,'.$len.'}).*#s',
                       '$1',$str);
}
?>

把上面两个例子整合了

<?php
/*
utf-8、gb2312都支持的汉字截取函数
cut_str(字符串, 截取长度, 开始长度, 编码);
编码默认为 utf-8
开始长度默认为 0
*/
 
function cut_str($string, $sublen, $start = 0, $code = 'utf-8')
{
    if($code == 'utf-8')
    {
        $pa = "/[x01-x7f]|[xc2-xdf][x80-xbf]|xe0[xa0-xbf][x80-xbf]|[xe1-xef][x80-xbf][x80-xbf]|xf0[x90-xbf][x80-xbf][x80-xbf]|[xf1-xf7][x80-xbf][x80-xbf][x80-xbf]/";
        preg_match_all($pa, $string, $t_string);
 
        if(count($t_string[0]) - $start > $sublen) return join('', array_slice($t_string[0], $start, $sublen))."...";
        return join('', array_slice($t_string[0], $start, $sublen));
    }
    else
    {
        $start = $start*2;
        $sublen = $sublen*2;
        $strlen = strlen($string);
        $tmpstr = '';
 
        for($i=0; $i< $strlen; $i++)
        {
            if($i>=$start && $i< ($start+$sublen))
            {
                if(ord(substr($string, $i, 1))>129)
                {
                    $tmpstr.= substr($string, $i, 2);
                }
                else
                {
                    $tmpstr.= substr($string, $i, 1);
                }
            }
            if(ord(substr($string, $i, 1))>129) $i++;
        }
        if(strlen($tmpstr)< $strlen ) $tmpstr.= "...";
        return $tmpstr;
    }
}
 
$str = "abcd需要截取的字符串";
echo cut_str($str, 8, 0, 'gb2312');
?>

开始研究gvim的配置文件(_vimrc)， 现在给大家看一下我产生乱码之前的配置

配置文件里enconding,fileeconding,fileecondings的含义：
encoding: gvim 内部使用的字符编码方式，包括 vim 的 buffer (缓冲区)、菜单文本、消息文本等。
用户手册上建议只在 .vimrc 中改变它的值，事实上似乎也只有在 .vimrc 中改变它的值才有意义。
fileencoding: gvim 中当前编辑的文件的字符编码方式，vim 保存文件时也会将文件保存为这种字符编码方式 (不管是否新文件都如此)。
fileencodings: gvim 启动时会按照它所列出的字符编码方式逐一探测即将打开的文件的字符编码方式，并且将 fileencoding 设置为最终探测到的字符编码方式。
因此最好将 unicode 编码方式放到这个列表的最前面，将拉丁语系编码方式 latin1 放到最后面。
其中：chinese 就是 cp963编码
只到这里我突然想起来，我的浏览里默认的字符集是 gbk的，而_vimrc里的设置编码是utf-8的，二者不对应，

colors desert
set nobackup
set guifont=courier_new:h12:cansi
"处理文本中显示乱码
set encoding=utf-8
set fileencodings=chinese
set fileencoding=chinese
"处理菜单及右键菜单乱码
source $vimruntime/delmenu.vim
source $vimruntime/menu.vim
"处理consle输出乱码
language messages zh_cn.utf-8
syntax enable
syntax on

fatal error: cannot redeclare这种问题php教程 开发可能会碰到过，原因是很简单的，就是重复调用了相同名字的函数，

function mydate($format='y-m-d h:i:s',$timest=0)
{
 global $cfg_cli_time;
 $addtime = $cfg_cli_time * 3600;
 if(empty($format))
 {
  $format = 'y-m-d h:i:s';
 }
 return gmdate ($format,$timest+$addtime);
}

面我的

require_once(dedeinc."/inc/inc_fun_funstring.php");

也包含了一个名为mydate的函数如果现在我们这样用就出现如

a.php

require_once(dedeinc."/inc/inc_fun_funstring.php");
function mydate($format='y-m-d h:i:s',$timest=0)
{
 global $cfg_cli_time;
 $addtime = $cfg_cli_time * 3600;
 if(empty($format))
 {
  $format = 'y-m-d h:i:s';
 }
 return gmdate ($format,$timest+$addtime);
}

就会出现fatal error: cannot redeclare mydate() (previously declared in

require()
require() 语句包括并运行指定文件。

require() 语句包括并运行指定文件。有关包括如何工作的详细信息见 include() 的文档。

require() 和 include() 除了怎样处理失败之外在各方面都完全一样。include() 产生一个警告而 require() 则导致一个致命错误。换句话说，如果你想在丢失文件时停止处理页面，那就别犹豫了，用 require() 吧。include() 就不是这样，脚本会继续运行。同时也要确认设置了合适的include_path。

例子 16-2. 基本的 require() 例子

<?php教程

require 'prepend.php';

require $somefile;

require ('somefile.txt');

?> 
 

更多例子参见 include() 文档。

注: 在 php 4.0.2 之前适用以下规则：require() 总是会尝试读取目标文件，即使它所在的行根本就不会执行。条件语句不会影响 require()。不过如果 require() 所在的行没有执行，则目标文件中的代码也不会执行。同样，循环结构也不影响 require() 的行为。尽管目标文件中包含的代码仍然是循环的主体，但 require() 本身只会运行一次。

注: 由于这是一个语言结构而非函数，因此它无法被“变量函数”调用。

include()
include() 语句包括并运行指定文件。

以下文档也适用于 require()。这两种结构除了在如何处理失败之外完全一样。include() 产生一个警告而 require() 则导致一个致命错误。换句话说，如果你想在遇到丢失文件时停止处理页面就用 require()。include() 就不是这样，脚本会继续运行。同时也要确认设置了合适的 include_path。

当一个文件被包括时，其中所包含的代码继承了 include 所在行的变量范围。从该处开始，调用文件在该行处可用的任何变量在被调用的文件中也都可用。

例子 16-3. 基本的 include() 例子

vars.php

<?php

$color = 'green';
$fruit = 'apple';

?>

test.php
<?php

echo "a $color $fruit"; // a

include 'vars.php';

echo "a $color $fruit"; // a green apple

?> 

如果 include 出现于调用文件中的一个函数里，则被调用的文件中所包含的所有代码将表现得如同它们是在该函数内部定义的一样。所以它将遵循该函数的变量范围。

例子 16-4. 函数中的包括

<?php

function foo()
{
   global $color;

   include 'vars.php';

   echo "a $color $fruit";
}

/* vars.php is in the scope of foo() so    *
 * $fruit is not available outside of this  *
 * scope.  $color is because we declared it *
 * as global.                              */

foo();                    // a green apple
echo "a $color $fruit";  // a green

?> 
 

当一个文件被包括时，语法解析器在目标文件的开头脱离 php 模式并进入 html 模式，到文件结尾处恢复。由于此原因，目标文件中应被当作 php 代码执行的任何代码都必须被包括在有效的 php 起始和结束标记之中。

如果“url fopen wrappers”在 php 中被激活（默认配置），可以用 url（通过 http 或者其它支持的封装协议 － 所支持的协议见 附录 l）而不是本地文件来指定要被包括的文件。如果目标服务器将目标文件作为 php 代码解释，则可以用适用于 http get 的 url 请求字符串来向被包括的文件传递变量。严格的说这和包括一个文件并继承父文件的变量空间并不是一回事；该脚本文件实际上已经在远程服务器上运行了，而本地脚本则包括了其结果。

警告
windows 版本的 php 在 4.3.0 版之前不支持本函数的远程文件访问，即使 allow_url_fopen 选项已被激活。
 

例子 16-5. 通过 http 进行的 include()

<?php

/* this example assumes that www.111cn.net is configured to parse .php *
 * files and not .txt files. also, 'works' here means that the variables *
 * $foo and $bar are available within the included file.                */

// won't work; file.txt wasn't handled by www.example.com as php
include 'http://www.example.com/file.txt?foo=1&bar=2';

// won't work; looks for a file named 'file.php?foo=1&bar=2' on the
// local filesystem.
include 'file.php?foo=1&bar=2';

// works.
include 'http://www.example.com/file.php?foo=1&bar=2';

$foo = 1;
$bar = 2;
include 'file.txt';  // works.
include 'file.php';  // works.

?> 
 

相关信息参见使用远程文件，fopen() 和 file()。

因为 include() 和 require() 是特殊的语言结构，在条件语句中使用必须将其放在语句组中（花括号中）。

例子 16-6. include() 与条件语句组

<?php

// this is wrong and will not work as desired.
if ($condition)
   include $file;
else
   include $other;

// this is correct.
if ($condition) {
   include $file;
} else {
   include $other;
}

?> 
 

处理返回值：可以在被包括的文件中使用 return() 语句来终止该文件中程序的执行并返回调用它的脚本。同样也可以从被包括的文件中返回值。可以像普通函数一样获得 include 呼叫的返回值。

注: 在 php 3 中，除非是在函数中调用否则被包括的文件中不能出现 return。在此情况下 return() 作用于该函数而不是整个文件。

例子 16-7. include() 和 return() 语句

return.php

<?php

$var = 'php';

return $var;

?>

noreturn.php
<?php

$var = 'php';

?>

testreturns.php
<?php

$foo = include 'return.php';

echo $foo; // prints 'php'

$bar = include 'noreturn.php';

echo $bar; // prints 1

?> 

$bar 的值为 1 是因为 include 成功运行了。注意以上例子中的区别。第一个在被包括的文件中用了 return() 而另一个没有。其它几种把文件“包括”到变量的方法是用 fopen()，file() 或者 include() 连同输出控制函数一起使用。

注: 由于这是一个语言结构而非函数，因此它无法被“变量函数”调用。
require_once()
require_once() 语句在脚本执行期间包括并运行指定文件。此行为和 require() 语句类似，唯一区别是如果该文件中的代码已经被包括了，则不会再次包括。有关此语句怎样工作参见 require() 的文档。

require_once() 应该用于在脚本执行期间同一个文件有可能被包括超过一次的情况下，你想确保它只被包括一次以避免函数重定义，变量重新赋值等问题。

使用 require_once() 和 include_once() 的例子见最新的 php 源程序发行包中的 pear 代码。

注: require_once() 是 php 4.0.1pl2 中新加入的。

注: 要注意 require_once() 和 include_once() 在大小写不敏感的操作系统中（例如 windows）的行为可能不是你所期望的。 例子 16-8. require_once() 在 windows 下不区分大小写

<?php
require_once("a.php"); // this will include a.php
require_once("a.php"); // this will include a.php again on windows!
?> 

警告
windows 版本的 php 在 4.3.0 版之前不支持本函数的远程文件访问，即使 allow_url_fopen 选项已被激活。
 

include_once()
the include_once() 语句在脚本执行期间包括并运行指定文件。此行为和 include() 语句类似，唯一区别是如果该文件中的代码已经被包括了，则不会再次包括。如同此语句名字暗示的那样，只会包括一次。

include_once() 应该用于在脚本执行期间同一个文件有可能被包括超过一次的情况下，你想确保它只被包括一次以避免函数重定义，变量重新赋值等问题。

使用 require_once() 和 include_once() 的更多例子见最新的 php 源程序发行包中的 pear 代码。

注: include_once() 是 php 4.0.1pl2 中新加入的。

注: 要注意 include_once() 和 require_once() 在大小写不敏感的操作系统中（例如 windows）的行为可能不是你所期望的。 例子 16-9. include_once() 在 windows 下不区分大小写

<?php
include_once("a.php"); // this will include a.php
include_once("a.php"); // this will include a.php again on windows!
?> 
 

警告
windows 版本的 php 在 4.3.0 版之前不支持本函数的远程文件访问，即使 allow_url_fopen 选项已被激活。