README

FileClient object can read from or write content to a file. And you can handle file read process for every line as you like by passing a callback or a closure to walk() method. This method is intended for database manipulation. For example, you can insert or update record from a read line.

Installation

To install FileClient with Composer just add the following to your composer.json file:

// composer.json
{
    // ...
    require: {
        // ...
        "satooshi/file-client": "dev-master"
    }
}

Then, you can install the new dependencies by running Composer’s update command from the directory where your composer.json file is located:

# install
$ php composer.phar install
# update
$ php composer.phar update satooshi/file-client

# or you can simply execute composer command if you set composer command to
# your PATH environment variable
$ composer install
$ composer update satooshi/file-client

Packagist page for this library is https://packagist.org/packages/satooshi/file-client

Or you can use git clone

# HTTP
$ git clone https://github.com/satooshi/FileClient.git
# SSH
$ git clone git@github.com:satooshi/FileClient.git

Usage

plain text file

construction

<?php

use Contrib\Component\File\Client\Plain\FileReader;

// construction
$path = '/path/to/file';
$client = new FileReader($path);

<?php

use Contrib\Component\File\Client\Plain\FileReader;

// default options
$options = array(
    'newLine'              => PHP_EOL,
    'throwException'       => true, // throw exception on runtime error
    'autoDetectLineEnding' => true, // better line ending handling on Mac
);

// construct with options
$client = new FileReader($path, $options);

read

<?php

use Contrib\Component\File\Client\Plain\FileReader;

$path = '/path/to/file';
$client = new FileReader($path);

// read
$content = $client->read();
$lines = $client->readLines();

write

<?php

use Contrib\Component\File\Client\Plain\FileWriter;

$path = '/path/to/file';
$client = new FileWriter($path);

// write
$content = 'hello world!';
$client->write($content);

$lines = array(
    'line1',
    'line2',
);
$client->writeLines($lines);

append

<?php

use Contrib\Component\File\Client\Plain\FileAppender;

$path = '/path/to/file';
$client = new FileAppender($path);

// append
$content = 'hello world!';
$client->write($content);

$lines = array(
    'line1',
    'line2',
);
$client->writeLines($lines);

walk

FileReaderIterator object can walk through read file.

<?php

use Contrib\Component\File\Client\Plain\FileReaderIterator;

// construction
$path = '/path/to/file';
$client = new FileReaderIterator($path);

<?php

use Contrib\Component\File\Client\Plain\FileReaderIterator;

// default options
$options = array(
    'newLine'              => PHP_EOL,
    'throwException'       => true, // throw exception on runtime error
    'autoDetectLineEnding' => true, // better line ending handling on Mac
    'skipEmptyCount'       => true,
    'limit'                => 0,
    'offset'               => 0,
);

// construct with options
$client = new FileReaderIterator($path, $options);

<?php

use Contrib\Component\File\Client\Plain\FileReaderIterator;

// construction
$path = '/path/to/file';
$client = new FileReaderIterator($path);

// walk
$client->walk(
    funtion ($line, $numLine) {
        if ($numLine === 1) {
            // do something at line 1
       }
    }
);

File format

Currently support json, xml, ltsv file format. Object serialization is also supported by Symfony Serializer component.

construction

<?php

use Contrib\Component\File\Client\Generic\GenericFileReader;

// construction
$path = '/path/to/file';
$client = new GenericFileReader($path);

<?php

use Contrib\Component\File\Client\Generic\GenericFileReader;

// default options
$options = array(
    'newLine'              => PHP_EOL,
    'throwException'       => true, // throw exception on runtime error
    'autoDetectLineEnding' => true, // better line ending handling on Mac
);

// construct with options
$client = new GenericFileReader($path, $options);

read

<?php

use Contrib\Component\File\Client\Generic\GenericFileReader;

$path = '/path/to/file';
$client = new GenericFileReader($path);

// read as json
$content = $client->readAs('json');
$lines = $client->readLinesAs('ltsv');

// read as json to object
$content = $client->readAs('json', 'Entity');
$lines = $client->readLinesAs('ltsv', 'Entity');

write

<?php

use Contrib\Component\File\Client\Generic\GenericFileWriter;

$path = '/path/to/file';
$client = new GenericFileWriter($path);

// write Entity
$content = new Entity();
$client->writeAs($content);

$lines = array(
    new Entity(),
    new Entity(),
);
$client->writeLinesAs($lines);

append

<?php

use Contrib\Component\File\Client\Generic\GenericFileAppender;

$path = '/path/to/file';
$client = new GenericFileAppender($path);

// append Entity
$content = new Entity();
$client->writeAs($content);

$lines = array(
    new Entity(),
    new Entity(),
);
$client->writeLinesAs($lines);

walk

<?php

use Contrib\Component\File\Client\Plain\GenericFileReaderIterator;

// construction
$path = '/path/to/file';
$client = new GenericFileReaderIterator($path);

<?php

use Contrib\Component\File\Client\Plain\GenericFileReaderIterator;

// default options
$options = array(
    'newLine'              => PHP_EOL,
    'throwException'       => true, // throw exception on runtime error
    'autoDetectLineEnding' => true, // better line ending handling on Mac
    'skipEmptyCount'       => true,
    'limit'                => 0,
    'offset'               => 0,
);

// construct with options
$client = new GenericFileReaderIterator($path, $options);

<?php

use Contrib\Component\File\Client\Plain\GenericFileReaderIterator;

// construction
$path = '/path/to/file';
$client = new GenericFileReaderIterator($path);

// walk as json
$client->walkAs(
    funtion ($line, $numLine) {
        if ($numLine === 1) {
            // do something at line 1
       }
    },
    'json'
);

// walk as json to object
$client->walkAs(
    funtion ($line, $numLine) {
        if ($numLine === 1) {
            // do something at line 1
       }
    },
    'json',
    'Entity'
);