初识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 参数指定了所要求到该流的访问类型。可以是以下：

fopen() 中 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 — 读取文件（可安全用于二进制文件）

 　　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;
?>