初识PHP(二)常用函数

在此记录一些常用库函数和常用语法以便查阅

一、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

参数指定了所要求到该流的访问类型。可以是以下：

[b]fopen() 中

mode

的可能值列表[/b]

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

个字节。 该函数在遇上以下几种情况时停止读取文件：

读取了

length

个字节

到达了文件末尾（EOF）

　　

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 新加的。

　　例子：

　　<?php echo file_get_contents("test.txt"); ?>

　　<?php
$homepage = file_get_contents('http://www.example.com/');
echo $homepage;
?>