PHP常用函数汇总:加密、文件操作与安全处理

追风的人
追风的人
发布时间:2026-10-13| 3人浏览过
原创

本文整理了PHP开发中常用的实用函数,涵盖数据加密解密、随机字符串生成、文件大小格式化、中文截取及客户端真实IP获取等。同时提供了防止SQL注入的过滤逻辑、强制文件下载、页面跳转提示以及时间戳转换等操作,帮助开发者提升开发效率与安全性。

结果与目标

在PHP应用开发中,我们经常需要处理字符编码、文件IO、用户请求安全以及界面交互。通过封装这些高频操作为独立函数,可以减少重复代码,提高可读性并增强基础功能的安全性。以下分类整理了一些经过验证的实用代码片段。

准备条件

  1. 确保服务器环境支持基本的PHP函数(如 mcrypt、mb_substr 等)。
  2. 理解输入参数的含义,特别是涉及加密时的密钥和安全级别。
  3. 对于涉及文件操作的函数,需确认当前进程对该路径具有读写权限。

具体操作函数详解

第1步:实现可逆字符串加密与解密

目的:将敏感字符串存入数据库时进行混淆,后续可通过密钥还原。

原理:使用 MCRYPT_RIJNDAEL_256 算法结合 md5 衍生的密钥进行CBC模式加密/解密,并使用Base64编码便于存储。

function encryptDecrypt($key, $string, $decrypt) {
    if($decrypt) {
        $decrypted = rtrim(mcrypt_decrypt(MCRYPT_RIJNDAEL_256, md5($key), base64_decode($string), MCRYPT_MODE_CBC, md5(md5($key))), "12");
        return $decrypted;
    } else {
        $encrypted = base64_encode(mcrypt_encrypt(MCRYPT_RIJNDAEL_256, md5($key), $string, MCRYPT_MODE_CBC, md5(md5($key))));
        return $encrypted;
    }
}

使用示例:

// 加密
echo encryptDecrypt('password', 'Helloweba欢迎您', 0);
// 解密
echo encryptDecrypt('password', '生成的密文', 1);

注意:mcrypt 扩展在PHP 7.2+已弃用,生产环境建议迁移至 OpenSSL 扩展。

第2步:生成指定长度的随机字符串

目的:生成临时密码、验证码或唯一标识符。

function generateRandomString($length = 10) {
    $characters = '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';
    $randomString = '';
    for ($i = 0; $i < $length; $i++) {
        $randomString .= $characters[rand(0, strlen($characters) - 1)];
    }
    return $randomString;
}

使用示例:调用 generateRandomString(20) 即可获取20位随机字符。

第3步:获取文件扩展名与格式化文件大小

目的:快速获取文件后缀用于类型判断,或将字节数转换为KB/MB/GB格式。

获取扩展名:

function getExtension($filename) {
    $myext = substr($filename, strrpos($filename, '.'));
    return str_replace('.','', $myext);
}

格式化大小:

function formatSize($size) {
    $sizes = array(" Bytes", " KB", " MB", " GB", " TB", " PB", " EB", " ZB", " YB");
    if ($size == 0) {  
        return('n/a');  
    } else { 
        return (round($size/pow(1024, ($i = floor(log($size, 1024)))), 2) . $sizes[$i]);  
    } 
}

第4步:批量替换字符串中的标签

目的:将自定义占位符(如模板标签)快速替换为HTML实体或其他内容。

function stringParser($string, $replacer) {
    $result = str_replace(array_keys($replacer), array_values($replacer), $string);
    return $result;
}

使用示例:可将 {b} 替换为 <b> 等自定义标记,适合简单的模板引擎逻辑。

第5步:列出目录下所有文件名

目的:遍历指定目录并输出非目录类的文件名。

function listDirFiles($DirPath) {
    if($dir = opendir($DirPath)){ 
        while(($file = readdir($dir))!== false){ 
            if(!is_dir($DirPath.$file)) 
                echo "filename: $file<br />"; 
        } 
    }
}

风险提醒:请确保传入的路径存在且具备读取权限,避免敏感目录被意外扫描。

第6步:获取当前页面完整URL

目的:构建包含协议、域名、端口和路径的绝对URL,适用于重定向或分享链接。

function curPageURL() {
    $pageURL = 'http';
    if (!empty($_SERVER['HTTPS'])) {$pageURL .= "s";}
    $pageURL .= "://";
    if ($_SERVER["SERVER_PORT"] != "80") {
        $pageURL .= $_SERVER["SERVER_NAME"].":".$_SERVER["SERVER_PORT"].$_SERVER["REQUEST_URI"];
    } else {
        $pageURL .= $_SERVER["SERVER_NAME"].$_SERVER["REQUEST_URI"];
    }
    return $pageURL;
}

第7步:强制浏览器下载文件

目的:阻止PDF等文件直接预览,改为触发下载对话框。

function download($filename) {
    if ((isset($filename))&&(file_exists($filename))){
        header("Content-length: ".filesize($filename));
        header('Content-Type: application/octet-stream');
        header('Content-Disposition: attachment; filename="' . $filename . '"');
        readfile("$filename");
    } else {
        echo "Looks like file does not exist!";
    }
}

使用示例:download('/down/test.zip');

第8步:支持多编码的字符串长度截取

目的:截断标题或摘要,支持UTF-8和GB2312编码,超出部分显示省略号。

function cutStr($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{
        // GB2312逻辑略...
    }
}

替代方案:若环境支持,优先使用 mb_substr() 或 iconv_substr(),代码更简洁。

第9步:获取客户端真实IP地址

目的:应对代理服务器场景,获取用户真实访问IP,用于日志记录或风控。

function getIp() {
    if (getenv("HTTP_CLIENT_IP") && strcasecmp(getenv("HTTP_CLIENT_IP"), "unknown"))
        $ip = getenv("HTTP_CLIENT_IP");
    else if (getenv("HTTP_X_FORWARDED_FOR") && strcasecmp(getenv("HTTP_X_FORWARDED_FOR"), "unknown"))
        $ip = getenv("HTTP_X_FORWARDED_FOR");
    else if (getenv("REMOTE_ADDR") && strcasecmp(getenv("REMOTE_ADDR"), "unknown"))
        $ip = getenv("REMOTE_ADDR");
    else if (isset ($_SERVER['REMOTE_ADDR']) && $_SERVER['REMOTE_ADDR'] && strcasecmp($_SERVER['REMOTE_ADDR'], "unknown"))
        $ip = $_SERVER['REMOTE_ADDR'];
    else
        $ip = "unknown";
    return ($ip);
}

现代优化版:推荐使用数组解析 HTTP_X_FORWARDED_FOR 以过滤多个代理IP:

function getClientIp() {
    $ip = NULL;
    if (isset($_SERVER['HTTP_X_FORWARDED_FOR'])) {
        $arr = explode(',', $_SERVER['HTTP_X_FORWARDED_FOR']);
        $pos = array_search('unknown',$arr);
        if(false !== $pos) unset($arr[$pos]);
        $ip = trim($arr[0]);
    } elseif (isset($_SERVER['HTTP_CLIENT_IP'])) {
        $ip = $_SERVER['HTTP_CLIENT_IP'];
    } elseif (isset($_SERVER['REMOTE_ADDR'])) {
        $ip = $_SERVER['REMOTE_ADDR'];
    }
    $ip = (false !== ip2long($ip)) ? $ip : '0.0.0.0';
    return $ip;
}

第10步:简易SQL注入防护

目的:通过正则表达式拦截常见的SQL关键字,作为基础防御手段。

function injCheck($sql_str) { 
    $check = preg_match('/select|insert|update|delete|'|/*|*|../|./|union|into|load_file|outfile/', $sql_str);
    if ($check) { 
        echo '非法字符!!'; exit; 
    } else { 
        return $sql_str; 
    } 
}

重要安全提示:此方法仅为辅助,生产环境中务必使用预处理语句(Prepared Statements)配合 PDO 或 MySQLi 来彻底防止SQL注入。

第11步:页面友好提示与自动跳转

目的:在操作成功后向用户展示提示页,并倒计时自动跳转至新页面。

function message($msgTitle, $message, $jumpUrl) {
    // ... 此处省略大量HTML/CSS拼接代码 ...
    // 核心JS跳转逻辑:
    // setTimeout("location.replace('".$jumpUrl."')", 2000);
}

使用示例:message('操作提示','操作成功!','https://example.com');

第12步:秒数转换为时:分:秒格式

目的:将时长数值转为人类可读的时间格式(hh:mm:ss)。

function changeTimeType($seconds) {
    if ($seconds > 3600) {
        $hours = intval($seconds / 3600);
        $minutes = $seconds % 3600;
        $time = $hours . ":" . gmstrftime('%M:%S', $minutes);
    } else {
        $time = gmstrftime('%H:%M:%S', $seconds);
    }
    return $time;
}

第13步:数字转大写人民币金额

目的:常用于发票打印或财务展示,将阿拉伯数字转换为中文大写。

function num2rmb ($num) {
    // ... 复杂的逐位转换逻辑 ...
    // 返回格式如:壹佰贰拾叁元整
}

完成判断

  • 上述函数可直接复制到项目的公共配置文件(如 functions.php)中。
  • 测试加密/解密函数时,确保输入的密文未被篡改,否则解密会失败或产生乱码。
  • 在使用 download 函数前,确认未发送其他Header信息,否则会导致“Header already sent”错误。

简要总结

以上整理涵盖了PHP开发中字符处理、文件IO、网络请求头分析及基础安全防护等领域的常用功能。通过复用这些经过提炼的代码块,可以有效减少样板代码,使业务逻辑更加清晰。需要注意的是,部分旧式函数(如 mcrypt)在现代PHP版本中可能不再可用,使用时请根据实际运行环境进行适配或升级替代方案。以上就是PHP常用函数汇总的详细内容,更多关于PHP开发技巧的资料请关注本站其它相关文章!

相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。