在此记录一些常用库函数和常用语法以便查阅
一、PHP手册
php手册中文地址 http://php.net/manual/zh
二、一些常用操作
2.1字符串操作
2.1.1 strpos — 查找字符串首次出现的位置
mixed strpos ( string $haystack , mixed $needle [, int $offset = 0 ] )
返回 needle 在 haystack 中首次出现的数字位置。
haystack
在该字符串中进行查找。
needle
如果 needle 不是一个字符串,那么它将被转换为整型并被视为字符的顺序值。
offset
如果提供了此参数,搜索会从字符串该字符数的起始位置开始统计。和 strrpos()、 strripos()不一样,这个偏移量不能是负数。
2.1.2 substr — 返回字符串的子串
string substr ( string $string , int $start [, int $length ] )
返回字符串 string 由 start 和 length 参数指定的子字符串。
string
输入字符串。
start
如果 start 是非负数,返回的字符串将从 string 的 start 位置开始,从 0 开始计算。例如,在字符串 “abcdef” 中,在位置 0 的字符是 “a”,位置 2 的字符串是 “c” 等等。
返回值:
如果 start 是负数,返回的字符串将从 string 结尾处向前数第 start 个字符开始。
如果 string 的长度小于或等于 start,将返回 FALSE。
2.1.3 str_split — 将字符串转换为数组
array split ( string $pattern , string $string [, int $limit ] )
将一个字符串转换为数组。
string 输入字符串。 split_length 每一段的长度。
返回值:
如果指定了可选的 split_length 参数,返回数组中的每个元素均为一个长度为 split_length 的字符块,否则每个字符块为单个字符。
如果 split_length 小于 1,返回 FALSE。如果 split_length 参数超过了 string 超过了字符串 string 的长度,整个字符串将作为数组仅有的一个元素返回。
2.1.4 explode — 使用一个字符串分割另一个字符串
array explode ( string $delimiter , string $string [, int $limit ] )
此函数返回由字符串组成的数组,每个元素都是 string 的一个子串,它们被字符串 delimiter 作为边界点分割出来。
delimiter
边界上的分隔字符。
string
输入的字符串。
limit
如果设置了 limit 参数并且是正数,则返回的数组包含最多 limit 个元素,而最后那个元素将包含 string的剩余部分。
如果 limit 参数是负数,则返回除了最后的 -limit 个元素外的所有元素。
如果 limit 是 0,则会被当做 1。
此函数返回由字符串组成的 array,每个元素都是 string 的一个子串,它们被字符串 delimiter 作为边界点分割出来。
返回值:如果 delimiter 为空字符串(""),explode() 将返回 FALSE。 如果 delimiter 所包含的值在 string 中找不到,并且使用了负数的 limit , 那么会返回空的 array, 否则返回包含 string 单个元素的数组。
2.1.5 preg_split — 通过一个正则表达式分隔字符串
array preg_split ( string $pattern , string $subject [, int $limit = -1 [, int $flags = 0 ]] )
通过一个正则表达式分隔给定字符串.
pattern
用于搜索的模式,字符串形式。
subject
输入字符串
limit
如果指定,将限制分隔得到的子串最多只有limit个,返回的最后一个 子串将包含所有剩余部分。limit值为-1, 0或null时都代表"不限制", 作为php的标准,你可以使用null跳过对flags的设置。
flags
flags 可以是任何下面标记的组合(以位或运算 | 组合):
PREG_SPLIT_NO_EMPTY 如果这个标记被设置, preg_split() 将进返回分隔后的非空部分。 PREG_SPLIT_DELIM_CAPTURE 如果这个标记设置了,用于分隔的模式中的括号表达式将被捕获并返回。 PREG_SPLIT_OFFSET_CAPTURE 如果这个标记被设置, 对于每一个出现的匹配返回时将会附加字符串偏移量. 注意:这将会改变返回数组中的每一个元素, 使其每个元素成为一个由第 0 个元素为分隔后的子串,第1个元素为该子串在subject中的偏移量组成的数组。 返回值:返回一个使用 pattern 边界分隔 subject 后得到 的子串组成的数组。
2.2 数组操作
2.2.1 array — 新建一个数组
array array ([ mixed $... ] )
创建一个数组。
语法“index => values”,用逗号分开,定义了索引和值。索引可以是字符串或数字。如果省略了索引,会自动产生从 0 开始的整数索引。如果索引是整数,则下一个产生的索引将是目前最大的整数索引 + 1。注意如果定义了两个完全一样的索引,则后面一个会覆盖前一个。
返回值:返回根据参数建立的数组。参数可以用 => 运算符给出索引。
2.2.2 array_push — 将一个或多个单元压入数组的末尾(入栈)
int array_push ( array &$array , mixed $var [, mixed $... ] )
array_push() 将 array 当成一个栈,并将传入的变量压入 array 的末尾。array 的长度将根据入栈变量的数目增加。
array 输入的数组。 var 要压入的值。 返回值:返回处理之后数组的元素个数。
2.3 索引制定文件/添加头文件
2.3.1 include 语句包含并运行指定文件
被包含文件先按参数给出的路径寻找,如果没有给出目录(只有文件名)时则按照 include_path 指定的目录寻找。如果在 include_path 下没找到该文件则 include 最后才在调用脚本文件所在的目录和当前工作目录下寻找。如果最后仍未找到文件则 include 结构会发出一条 警告;这一点和 require 不同,后者会发出一个 致命错误。
如果定义了路径——不管是绝对路径(在 Windows 下以盘符或者 \ 开头,在 Unix/Linux 下以 / 开头)还是当前目录的相对路径(以 . 或者 .. 开头)——include_path 都会被完全忽略。例如一个文件以 ../ 开头,则解析器会在当前目录的父目录下寻找该文件。
当一个文件被包含时,其中所包含的代码继承了 include 所在行的变量范围。从该处开始,调用文件在该行处可用的任何变量在被调用的文件中也都可用。不过所有在包含文件中定义的函数和类都具有全局作用域。
2.3.2 require 语句包含并运行指定文件
require 和 include 几乎完全一样,除了处理失败的方式不同之外。require 在出错时产生 E_COMPILE_ERROR 级别的错误。换句话说将导致脚本中止而 include 只产生警告(E_WARNING),脚本会继续运行。
三、常用库函数
3.1 时间
3.1.1 time — 返回当前的 Unix 时间戳
int time ( void )
返回自从 Unix 纪元(格林威治时间 1970 年 1 月 1 日 00:00:00)到当前时间的秒数。
3.1.2 date — 格式化一个本地时间/日期
string date ( string $format [, int $timestamp ] )
返回将整数 timestamp 按照给定的格式字串而产生的字符串。如果没有给出时间戳则使用本地当前时间。换句话说,timestamp 是可选的,默认值为 time()。
format 具体格式:http://php.net/manual/zh/function.date.php
3.1.3 date_default_timezone_get — 取得一个脚本中所有日期时间函数所使用的默认时区
string date_default_timezone_get ( void )
本函数返回默认时区
3.1.4 date_default_timezone_set — 设定用于一个脚本中所有日期时间函数的默认时区
bool date_default_timezone_set ( string $timezone_identifier )
设定用于所有日期时间函数的默认时区。
timezone_identifier
时区标识符,例如 UTC 或 Asia/Shanghai(中国大陆选这个)。合法标识符列表见http://php.net/manual/zh/timezones.php
返回值:如果 timezone_identifier 参数无效则返回 FALSE,否则返回 TRUE。
3.2 JSON格式操作
3.2.1 json_encode — 对变量进行 JSON 编码
string json_encode ( mixed $value [, int $options = 0 [, int $depth = 512 ]] )
返回 value 值的 JSON 形式
value
待编码的 value ,除了resource 类型之外,可以为任何数据类型。该函数只能接受 UTF-8 编码的数据
options
二进制掩码常量。具体见http://php.net/manual/zh/json.constants.php
depth
设置最大深度。 必须大于0。
返回值:成功则返回 JSON 编码的 string 或者在失败时返回 FALSE 。
3.2.2 json_decode — 对 JSON 格式的字符串进行解码
mixed json_decode ( string $json [, bool $assoc = false [, int $depth = 512 [, int $options = 0]]] )
接受一个 JSON 格式的字符串并且把它转换为 PHP 变量
json 待解码的 json string 格式的字符串。该函数只能接受 UTF-8 编码的数据 assoc 当该参数为 TRUE 时,将返回 array 而非 object 。 depth 设置最大深度。 必须大于0。 options 二进制掩码常量。只支持 JSON_BIGINT_AS_STRING
3.3文件操作
3.3.1 fopen — 打开文件或者 URL
resource fopen ( string $filename , string $mode [, bool $use_include_path = false [, resource$context ]] )
fopen() 将 filename 指定的名字资源绑定到一个流上。
filename
如果 filename 是 "scheme://..." 的格式,则被当成一个 URL,PHP 将搜索协议处理器(也被称为封装协议)来处理此模式。如果该协议尚未注册封装协议,PHP 将发出一条消息来帮助检查脚本中潜在的问题并将filename 当成一个普通的文件名继续执行下去。
如果 PHP 认为 filename 指定的是一个本地文件,将尝试在该文件上打开一个流。该文件必须是 PHP 可以访问的,因此需要确认文件访问权限允许该访问。如果激活了安全模式或者 open_basedir 则会应用进一步的限制。
mode
mode 参数指定了所要求到该流的访问类型。可以是以下:
fopen() 中 mode 的可能值列表'r' | 只读方式打开,将文件指针指向文件头。 |
'r+' | 读写方式打开,将文件指针指向文件头。 |
'w' | 写入方式打开,将文件指针指向文件头并将文件大小截为零。如果文件不存在则尝试创建之。 |
'w+' | 读写方式打开,将文件指针指向文件头并将文件大小截为零。如果文件不存在则尝试创建之。 |
'a' | 写入方式打开,将文件指针指向文件末尾。如果文件不存在则尝试创建之。 |
'a+' | 读写方式打开,将文件指针指向文件末尾。如果文件不存在则尝试创建之。 |
'x' | 创建并以写入方式打开,将文件指针指向文件头。如果文件已存在,则 fopen() 调用失败并返回FALSE,并生成一条 E_WARNING 级别的错误信息。如果文件不存在则尝试创建之。这和给 底层的open(2) 系统调用指定 O_EXCL|O_CREAT 标记是等价的。 |
'x+' | 创建并以读写方式打开,其他的行为和 'x' 一样。 |
use_include_path
如果也需要在 include_path 中搜寻文件的话,可以将可选的第三个参数 use_include_path 设为 '1' 或TRUE。
context
上下文
返回值:
成功时返回文件指针资源,如果打开失败,本函数返回 FALSE。
错误提示:如果打开失败,会产生一个 E_WARNING 错误。可以通过 @ 来屏蔽错误。
3.3.2 fgets — 从文件指针中读取一行
string fgets ( resource $handle [, int $length ] )
从文件指针中读取一行。
handle
文件指针必须是有效的,必须指向由 fopen() 或 fsockopen() 成功打开的文件(并还未由 fclose() 关闭)。
length
从 handle 指向的文件中读取一行并返回长度最多为 length - 1 字节的字符串。碰到换行符(包括在返回值中)、EOF 或者已经读取了 length - 1 字节后停止(看先碰到那一种情况)。如果没有指定 length,则默认为 1K,或者说 1024 字节。
返回值:
从指针 handle 指向的文件中读取了 length - 1 字节后返回字符串。 如果文件指针中没有更多的数据了则返回FALSE。
错误发生时返回 FALSE。
3.3.3 fread — 读取文件(可安全用于二进制文件)
string fread ( resource $handle , int $length )
fread() 从文件指针 handle 读取最多 length 个字节。 该函数在遇上以下几种情况时停止读取文件:
handle
文件系统指针,是典型地由 fopen() 创建的 resource(资源)。
length
最多读取 length 个字节。
返回值:返回所读取的字符串, 或者在失败时返回 FALSE。
3.3.4 fwrite — 写入文件(可安全用于二进制文件)
int fwrite ( resource $handle , string $string [, int $length ] )
fwrite() 把 string 的内容写入 文件指针 handle 处。
handle
文件系统指针,是典型地由 fopen() 创建的 resource(资源)。
string
将要写入的字符串
ength
如果指定了 length,当写入了 length 个字节或者写完了 string 以后,写入就会停止,视乎先碰到哪种情况。
返回值:fwrite() 返回写入的字符数,出现错误时则返回 FALSE 。
3.3.5 fclose — 关闭一个已打开的文件指针
bool fclose ( resource $handle )
将 handle 指向的文件关闭。
handle
文件指针必须有效,并且是通过 fopen() 或 fsockopen() 成功打开的。
返回值:成功时返回 TRUE, 或者在失败时返回 FALSE。
3.3.6 file_get_contents — 将整个文件读入一个字符串
string file_get_contents ( string $filename [, bool $use_include_path = false [, resource$context [, int $offset = -1 [, int $maxlen ]]]] )
和 file() 一样,只除了 file_get_contents() 把文件读入一个字符串。将在参数 offset 所指定的位置开始读取长度为maxlen 的内容。如果失败, file_get_contents() 将返回 FALSE。
该函数无需打开文件和关闭文件流!非常方便。
file_get_contents() 函数是用来将文件的内容读入到一个字符串中的首选方法。如果操作系统支持还会使用内存映射技术来增强性能。
如果要打开有特殊字符的 URL (比如说有空格),就需要使用 urlencode() 进行 URL 编码。
path | 必需。规定要读取的文件。 |
include_path | 可选。如果也想在 include_path 中搜寻文件的话,可以将该参数设为 "1"。 |
context |
可选。规定文件句柄的环境。 context 是一套可以修改流的行为的选项。若使用 null,则忽略。 |
start | 可选。规定在文件中开始读取的位置。该参数是 PHP 5.1 新加的。 |
max_length | 可选。规定读取的字节数。该参数是 PHP 5.1 新加的。 |
例子:
$homepage = file_get_contents('http://www.example.com/');
echo $homepage;
?>