Download the PHP package tii/csv-state-parser without Composer

On this page you can find all versions of the php package tii/csv-state-parser. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package csv-state-parser

Contributors Forks Stargazers Issues MIT License


CSV State Parser

Parses CSV files with a simple finite-state machine.

Table of Contents
  1. Getting Started
  2. Installation
  3. Contributing
  4. License
  5. Contact

Installation

Installation is simple.

Just run composer require tii/csv-state-parser

(back to top)

Usage

Create a Parser class that extends \Tii\CsvStateParser\CsvStateParser and implement the stateStart and result methods. See below for a full example.

Every row gets passed into the current actives stateMethod (stateStart in the beginning).

You can change the state from the next row on by calling $this->state($nextState) and pass a String backed enum or a value that can be cast to string. The next row will get passed to the corresponding stateMethod. I.e. if you call $this->state('fooBar') the next row will get passed to stateFooBar(array $row).

If you need to convert every field in the CSV file beforehand you can overwrite the protected function mapValue(string $value): string method. This is i.e. useful for encoding conversions.

There are a few additional helpers that help you achieve stuff:

method description
$this->done(); Tell the parser to quit early.
$this->skip(int $count) Tell the parser to skip $count lines before calling the stateMethod again.

You are responsible for compiling the data that the parser should return at the end yourself. This data should be returned by the result() method.

Here is a full example:

You can use your parser by instantiating it, and calling the parse(string $filename) method. \ If you need to adjust the separator, enclosure and escape char you can pass those to the constructor.

⚠️ Beware! In contrast to PHPs fgetcsv function this package uses ';' as the default separator character for CSV files.

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

Top contributors:

contrib.rocks image

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)

Contact

Tii - @Tii - [email protected]

Project Link: https://github.com/TiiFuchs/csv-state-parser

(back to top)


All versions of csv-state-parser with dependencies

PHP Build Version
Package Version
Requires php Version ^8.2
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package tii/csv-state-parser contains the following files

Loading the files please wait ...