在此记录一些常用库函数和常用语法以便查阅
一、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
, 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
- 要压入的值。
- 返回值:返回处理之后数组的元素个数。
如果定义了路径——不管是绝对路径(在 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
。
$json
[, bool $assoc
= false [, int $depth
= 512 [, int $options
= 0]]] )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
参数指定了所要求到该流的访问类型。可以是以下:
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 — 读取文件(可安全用于二进制文件)
$handle
, int $length
) fread() 从文件指针 handle
读取最多 length
个字节。 该函数在遇上以下几种情况时停止读取文件:
- 读取了
length
个字节 - 到达了文件末尾(EOF)
handle
文件系统指针,是典型地由 fopen() 创建的 resource(资源)。
length
最多读取 length
个字节。
返回值:返回所读取的字符串, 或者在失败时返回 FALSE
。
3.3.4 fwrite — 写入文件(可安全用于二进制文件)
$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
。
$filename
[, bool $use_include_path
= false [, resource$context
[, int $offset
= -1 [, int $maxlen
]]]] )offset
所指定的位置开始读取长度为maxlen
的内容。如果失败,file_get_contents() 将返回 FALSE
。参数 | 描述 |
---|---|
path | 必需。规定要读取的文件。 |
include_path | 可选。如果也想在 include_path 中搜寻文件的话,可以将该参数设为 "1"。 |
context | 可选。规定文件句柄的环境。 context 是一套可以修改流的行为的选项。若使用 null,则忽略。 |
start | 可选。规定在文件中开始读取的位置。该参数是 PHP 5.1 新加的。 |
max_length | 可选。规定读取的字节数。该参数是 PHP 5.1 新加的。 |
例子:
<?php echo file_get_contents("test.txt"); ?>
<?php
$homepage = file_get_contents('http://www.example.com/');
echo $homepage;
?>