搜索和替换文件或目录的一个好类--很实用

这是个非常有用的程序，可以对文本文件进行特定的搜索，并以特定的文字替换指定的文字，举个例子说如果我这篇文章里有一个字全部打错了，有几十处，要一一找出来修改是件很麻烦的事，用下面这个就可以轻松搞定。--teaman.oso.com.cn
类文件 search_replace.inc
<?php


        class search_replace{

                var $find;
                var $replace;
                var $files;
                var $directories;
                var $include_subdir;
                var $ignore_lines;
                var $ignore_sep;
                var $occurences;
                var $search_function;
                var $last_error;

        //以下进行函数定义和设置

                function search_replace($find, $replace, $files, $directories = '', $include_subdir = 1, $ignore_lines = array()){

                        $this->find            = $find;
                        $this->replace         = $replace;
                        $this->files           = $files;
                        $this->directories     = $directories;
                        $this->include_subdir  = $include_subdir;
                        $this->ignore_lines    = $ignore_lines;

                        $this->occurences      = 0;
                        $this->search_function = 'search';
                        $this->last_error      = '';

                }

        /***************************************
        ** accessor for retrieving occurences.
        ***************************************/
                function get_num_occurences(){
                        return $this->occurences;
                }

        //获取最后的错误
                function get_last_error(){
                        return $this->last_error;
                }

        //设置find变量
                function set_find($find){
                        $this->find = $find;
                }

        //设置replace变量
                function set_replace($replace){
                        $this->replace = $replace;
                }

        //设置file变量
                function set_files($files){
                        $this->files = $files;
                }

        //设置目录变量
                function set_directories($directories){
                        $this->directories = $directories;
                }

        //设置目录变量 set_include_subdir
                function set_include_subdir($include_subdir){
                        $this->include_subdir = $include_subdir;
                }

        //设置ignore_lines变量
                function set_ignore_lines($ignore_lines){
                        $this->ignore_lines = $ignore_lines;
                }

        //确定是哪一种搜索方式
                function set_search_function($search_function){
                        switch($search_function){
                                case 'normal': $this->search_function = 'search';
                                               return true;
                                               break;

                                case 'quick' : $this->search_function = 'quick_search';
                                               return true;
                                               break;

                                case 'preg'  : $this->search_function = 'preg_search';
                                               return true;
                                               break;

                                case 'ereg'  : $this->search_function = 'ereg_search';
                                               return true;
                                               break;

                                default      : $this->last_error      = 'invalid search function specified';
                                               return false;
                                               break;
                        }
                }


        //以下为搜索和替换程序的主文件
                function search($filename){

                        $occurences = 0;
                        $file_array = file($filename);

                        for($i=0; $i<count($file_array); $i++){
                                $continue_flag = 0;
                                if(count($this->ignore_lines) > 0){
                                        for($j=0; $j<count($this->ignore_lines); $j++){
                                                if(substr($file_array[$i],0,strlen($this->ignore_lines[$j])) == $this->ignore_lines[$j]) $continue_flag = 1;
                                        }
                                }
                                if($continue_flag == 1) continue;
                                $occurences += count(explode($this->find, $file_array[$i])) - 1;
                                $file_array[$i] = str_replace($this->find, $this->replace, $file_array[$i]);
                        }
                        if($occurences > 0) $return = array($occurences, implode('', $file_array)); else $return = false;
                        return $return;

                }

        //使用quick(快速)搜索方法时，没有igonre_lines功能
                function quick_search($filename){

                        clearstatcache();

                        $file       = fread($fp = fopen($filename, 'r'), filesize($filename)); fclose($fp);
                        $occurences = count(explode($this->find, $file)) - 1;
                        $file       = str_replace($this->find, $this->replace, $file);

                        if($occurences > 0) $return = array($occurences, $file); else $return = false;
                        return $return;

                }

        //preg搜索方法不支持ignore_lines
                function preg_search($filename){

                        clearstatcache();

                        $file       = fread($fp = fopen($filename, 'r'), filesize($filename)); fclose($fp);
                        $occurences = count($matches = preg_split($this->find, $file)) - 1;
                        $file       = preg_replace($this->find, $this->replace, $file);

                        if($occurences > 0) $return = array($occurences, $file); else $return = false;
                        return $return;

                }

        //ereg搜索方法也不支持ignore_lines
                function ereg_search($filename){

                        clearstatcache();

                        $file = fread($fp = fopen($filename, 'r'), filesize($filename)); fclose($fp);

                        $occurences = count($matches = split($this->find, $file)) -1;
                        $file       = ereg_replace($this->find, $this->replace, $file);

                        if($occurences > 0) $return = array($occurences, $file); else $return = false;
                        return $return;

                }

        //写新文件
                function writeout($filename, $contents){

                        if($fp = @fopen($filename, 'w')){
                                fwrite($fp, $contents);
                                fclose($fp);
                        }else{
                                $this->last_error = 'could not open file: '.$filename;
                        }

                }

        //由do_search调用，排出所有要搜索的文件
                function do_files($ser_func){
                        if(!is_array($this->files)) $this->files = explode(',', $this->files);
                        for($i=0; $i<count($this->files); $i++){
                                if($this->files[$i] == '.' or $this->files[$i] == '..') continue;
                                if(is_dir($this->files[$i]) == true) continue;
                                $newfile = $this->$ser_func($this->files[$i]);
                                if(is_array($newfile) == true){
                                        $this->writeout($this->files[$i], $newfile[1]);
                                        $this->occurences += $newfile[0];
                                }
                        }
                }

        //由do_search()调用，排出所有要搜索的目录
                function do_directories($ser_func){
                        if(!is_array($this->directories)) $this->directories = explode(',', $this->directories);
                        for($i=0; $i<count($this->directories); $i++){
                                $dh = opendir($this->directories[$i]);
                                while($file = readdir($dh)){
                                        if($file == '.' or $file == '..') continue;

                                        if(is_dir($this->directories[$i].$file) == true){
                                                if($this->include_subdir == 1){
                                                        $this->directories[] = $this->directories[$i].$file.'/';
                                                        continue;
                                                }else{
                                                        continue;
                                                }
                                        }

                                        $newfile = $this->$ser_func($this->directories[$i].$file);
                                        if(is_array($newfile) == true){
                                                $this->writeout($this->directories[$i].$file, $newfile[1]);
                                                $this->occurences += $newfile[0];
                                        }
                                }
                        }
                }

        //调用这个do_search()就可以开始对文件或目录进行搜索
                function do_search(){
                        if($this->find != ''){
                                if((is_array($this->files) and count($this->files) > 0) or $this->files != '') $this->do_files($this->search_function);
                                if($this->directories != '')                                       $this->do_directories($this->search_function);
                        }
                }

        } // end of class
?>

//下面是调用该类的例子说明,请存为example.php

<?php

        include('search_replace.inc');  //将文件包括进来

//建立新物件，设置搜索条件、最后返回搜索结果

        $sr = new search_replace('asp', 'php', array('test.txt')); //调用搜索与替换
        $sr->set_search_function('quick');   //设置搜索条件
        $sr->do_search();

        $sr->set_find('another');
        $sr->do_search();

//下面是定制的返回信息
        header('content-type: text/plain');
        echo '发现和替换以下几个地方: '.$sr->get_num_occurences()."\r\n";
        echo '啊，错误发生如下.............: '.$sr->get_last_error()."\r\n";
?>

//将以下文字存为test.txt,注意text.txt必须是可读可写的
"我非常喜欢asp,它简单易学，功能强，听说asp已经占了大半市场，asp真好。"

此时，如果您打开exampe.php 就会出现下面这些：
发现和替换以下几个地方:3
啊，错误发生如下..........:      
查看test.txt文件，果然出现asp的地方被php替换了。