D. 公共函数速查

概述

以下函数定义在 app/common.php 中，可在任何地方直接调用。

字符串 / 加密

函数	说明	签名
random_string($length)	生成随机字符串	string random_string(int $length = 16)
encrypt_password($password, $salt)	密码加密（bcrypt）	array encrypt_password(string $password, ?string $salt = null)
verify_password($password, $hash, $salt)	验证密码	bool verify_password(string $password, string $encryptPassword, string $salt)

文件处理

函数	说明	签名
upload_file($formName, $type)	上传文件到临时目录	array upload_file(string $formName = 'file', string $type = 'file')
save_file($fileUrl, $saveDir)	临时文件迁移到正式目录	string|false save_file(string $fileUrl, string $saveDir = '')
save_content(&$content, $saveDir)	处理富文本中的媒体文件	bool save_content(string &$content, string $saveDir = 'article')
get_file_url($path)	相对路径转完整 URL	string get_file_url(string $path)
create_file_path($saveDir, $ext)	生成文件存储路径	string create_file_path(string $saveDir = '', string $ext = '')
save_remote_file($url, $saveDir)	保存远程文件	string|false save_remote_file(string $url, string $saveDir = '')
detect_image_ext($content)	根据内容检测图片后缀	?string detect_image_ext(string $content)

驼峰 / 下划线转换

函数	说明	签名
snake_to_camel($str)	下划线转驼峰	string snake_to_camel(string $str)
camel_to_snake($str)	驼峰转下划线	string camel_to_snake(string $str)
array_snake_to_camel($data)	数组键名下划线转驼峰（递归）	array array_snake_to_camel(array $data)
array_camel_to_snake($data, $except)	数组键名驼峰转下划线（递归）	array array_camel_to_snake(array $data, array $except = [])
is_camel_convert_enabled()	是否开启转换	bool is_camel_convert_enabled()

工具函数

函数	说明	签名
get_client_ip()	获取客户端 IP	string get_client_ip()
format_page_params($params)	格式化分页参数	array format_page_params(array $params)

使用示例

// 生成随机字符串
$str = random_string(32);

// 密码加密
$result = encrypt_password('123456');
// ['password' => '$2y$12$...', 'salt' => 'xK7pMn3qRt']

// 验证密码
$ok = verify_password('123456', $user->password, $user->salt);

// 文件上传
$result = upload_file('avatar', 'image');
if (isset($result['error'])) {
    return Result::fail($result['error']);
}

// 驼峰转换
camel_to_snake('createTime');    // 'create_time'
snake_to_camel('create_time');   // 'createTime'