5. 文件操作

5.1 文件包含

语法

include 'a.php';
// 或
require 'b.php';

区别：错误处理方式
- require 生成一个致命错误（E_COMPILE_ERROR），在错误发生后脚本会停止执行。
- include 生成一个警告（E_WARNING），在错误发生后脚本会继续执行。

5.2 文件读写

5.2.1 文件读写

1. 打开文件 fopen()

fopen()

<?php
$file = fopen("a.txt","r");
// 参数1：文件名
// 参数2：模式
?>

模式介绍
- r 只读。在文件的开头开始。
- r+ 读/写。在文件的开头开始。
- w 只写。打开并清空文件的内容；如果文件不存在，则创建新文件。
- w+ 读/写。打开并清空文件的内容；如果文件不存在，则创建新文件。
- a 追加。打开并向文件末尾进行写操作，如果文件不存在，则创建新文件。
- a+ 读/追加。通过向文件末尾写内容，来保持文件内容。
- x 只写。创建新文件。如果文件已存在，则返回 FALSE 和一个错误。
- x+ 读/写。创建新文件。如果文件已存在，则返回 FALSE 和一个错误。
如果 fopen() 函数无法打开指定文件，则返回 0 (false)。

2. 数据读取 fgets()

fgets()函数用于从文件中逐行读取（调用此函数1后，指针会移动到下一行）。
feof()函数用于检测指针是否到文件末尾（EOF）
fclose()函数用于关闭文件。

逐行读取

<?php
$file = fopen("welcome.txt", "r") or exit("无法打开文件!");
// 读取文件每一行，直到文件结尾
while(!feof($file))
{
    echo fgets($file). "<br>";
}
fclose($file);
?>

逐字读取

<?php
$file=fopen("welcome.txt","r") or exit("无法打开文件!");
while (!feof($file))
{
    echo fgetc($file);
}
fclose($file);
?>

3. 数据写入 fwrite()

fwrite()
语法
- fwrite(file,string,length)
参数
- file：文件名
- string：写入字符串
- length：写入最大字节（可选）

5.2.2 其它方式读写

读取 file_get_contents()

file_get_contents()：把整个文件读入一个字符串。

语法

file_get_contents(path,include_path,context,start,max_length)

参数
- path：必需。规定要读取的文件。
- include_path：可选。如果您还想在 include_path（在 php.ini 中）中搜索文件的话，请设置该参数为 ‘1’。
- context：可选。规定文件句柄的环境。context 是一套可以修改流的行为的选项。若使用 NULL，则忽略。
- start：可选。规定在文件中开始读取的位置。该参数是 PHP 5.1 中新增的。
- max_length：可选。规定读取的字节数。该参数是 PHP 5.1 中新增的。

实例：

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

写入 file_put_contents()

file_put_contents()
语法

int file_put_contents ( string $filename , mixed $data [, int $flags = 0 [, resource $context ]] )

参数
- file：必需。规定要写入数据的文件。如果文件不存在，则创建一个新文件。
- data：必需。规定要写入文件的数据。可以是字符串、数组或数据流。
- mode：可选。规定如何打开/写入文件。可能的值：
  - FILE_USE_INCLUDE_PATH
  - FILE_APPEND
  - LOCK_EX
- context：可选。规定文件句柄的环境。context 是一套可以修改流的行为的选项。

实例1

<?php
echo file_put_contents("sites.txt","teststring");
?>

实例2

<?php
$file = 'sites.txt';

$site = "\nGoogle";
// 向文件追加写入内容
// 使用 FILE_APPEND 标记，可以在文件末尾追加内容
//  LOCK_EX 标记可以防止多人同时写入
file_put_contents($file, $site, FILE_APPEND | LOCK_EX);
?>

5.3 文件上传

5.3.1 文件上传

HTML 中input标签的type 值改为file。

<input type="file" name="file" />

5.3.2 文件接收

通过使用 PHP 的全局数组 $_FILES 接收。
第一个参数是表单的 input name，第二个下标可以是 “name”、“type”、“size”、“tmp_name” 或 “error”。

<?php
$_FILES["file"]["name"]
// 上传文件的名称
$_FILES["file"]["type"]
// 上传文件的类型
$_FILES["file"]["size"]
// 上传文件的大小，以字节计
$_FILES["file"]["tmp_name"]
// 存储在服务器的文件的临时副本的名称
$_FILES["file"]["error"]
// 由文件上传导致的错误代码
?>

5.3.3 上传限制

<?php
$allowedExts = array("gif", "jpeg", "jpg", "png");
// 允许上传的图片后缀

$temp = explode(".", $_FILES["file"]["name"]);
// 将文件名和文件后缀分割
$extension = end($temp);
// 获取文件后缀名

if ((($_FILES["file"]["type"] == "image/gif")
        || ($_FILES["file"]["type"] == "image/jpeg")
        || ($_FILES["file"]["type"] == "image/jpg")
        || ($_FILES["file"]["type"] == "image/pjpeg")
        || ($_FILES["file"]["type"] == "image/x-png")
        || ($_FILES["file"]["type"] == "image/png"))
        // 类型检测
    && ($_FILES["file"]["size"] < 204800)
    // 大小限制，小于 200 kb
    && in_array($extension, $allowedExts)
)
// 后缀限制
{
    if ($_FILES["file"]["error"] > 0)
    // 上传失败
    {
        echo "错误：: " . $_FILES["file"]["error"] . "<br>";
    } else
    // 上传成功
    {
        echo "上传文件名: " . $_FILES["file"]["name"] . "<br>";
        echo "文件类型: " . $_FILES["file"]["type"] . "<br>";
        echo "文件大小: " . ($_FILES["file"]["size"] / 1024) . " kB<br>";
        echo "文件临时存储的位置: " . $_FILES["file"]["tmp_name"];
    }
} else {
    echo "非法的文件格式";
}

5.3.4 文件保存

if ($_FILES["file"]["error"] > 0)
    {
        echo "错误：: " . $_FILES["file"]["error"] . "<br>";
    }
    else
    {
        echo "上传文件名: " . $_FILES["file"]["name"] . "<br>";
        echo "文件类型: " . $_FILES["file"]["type"] . "<br>";
        echo "文件大小: " . ($_FILES["file"]["size"] / 1024) . " kB<br>";
        echo "文件临时存储的位置: " . $_FILES["file"]["tmp_name"] . "<br>";
        
        // 判断当前目录下的 upload 目录是否存在该文件
        // 如果没有 upload 目录，你需要创建它，upload 目录权限为 777
        if (file_exists("upload/" . $_FILES["file"]["name"]))
        {
            echo $_FILES["file"]["name"] . " 文件已经存在。 ";
        }
        else
        {
            // 如果 upload 目录不存在该文件则将文件上传到 upload 目录下
            move_uploaded_file($_FILES["file"]["tmp_name"], "upload/" . $_FILES["file"]["name"]);
            echo "文件存储在: " . "upload/" . $_FILES["file"]["name"];
        }
    }