PHP By Example


<?php
/**
 * PHP By Example
 *
 * @copyright 2014 Michel Corne 
 * @license   http://www.opensource.org/licenses/gpl-3.0.html GNU GPL v3
 */

require_once 'models/filter.php';
require_once 'models/function_core.php';

/**
 * Function configuration
 *
 * @see docs/function-configuration.txt
 */

class fread extends function_core
{
    public $examples = [
        [
            'filename' => filter::DEFAULT_FILENAME,
            'mode'     => 'rb',
            '$handle',
            5,
        ],
        [
            'filename' => 'http://www.example.com/',
            'mode'     => 'rb',
            '$handle',
            100,
        ],
        [
            'filename' => 'http://www.xyz.com/',
            'mode'     => 'r',
            '$handle',
            100000,
        ],
        [
            'filename' => filter::DEFAULT_FILENAME,
            'mode'     => 'rb',
            '$handle',
        ],
    ];

    public $input_args = 'filename';

    public $options_list = ['mode' => ['a', 'a+', 'c', 'c+', 'r', 'r+', 'w', 'w+', 'x', 'x+']];

    public $source_code = '
        // loads some data in a temp file
        $_filename = tempnam(sys_get_temp_dir(), "pbe");
        file_put_contents($_filename, "Hello world !");

        // opens the file or url
        $_mode =
            $mode; // string $mode
        $_handle = fopen(
            $filename, // string $filename
            "$mode");

        inject_function_call

        // removes the temp file
        fclose($_handle);
        unlink($_filename);
    ';

    public $synopsis = 'string fread ( resource $handle , int $length )';

    public $test_not_to_run = [1, 2];

    function post_exec_function()
    {
        fclose($this->returned_params['handle']);
    }

    function pre_exec_function()
    {
        $filename = $this->_filter->filter_filename('filename', true);
        $mode = $this->_filter->filter_arg_value('mode');
        $this->returned_params['handle'] = fopen($filename, $mode);

        if ($this->_function_params->get_param('length')) {
            $this->_filter->filter_file_length('length', $filename);
        }
        // else: the length is empty which is caught by the function itself
    }
}
Configuration of fread() 本页面仅提供英文版本。
