danog/file
1
0
Fork 0
mirror of https://github.com/danog/file.git synced 2024-11-26 11:54:54 +01:00
Code Issues Projects Releases Wiki Activity

Update LICENSE and README

Browse Source
This commit is contained in:
Niklas Keller 2017-06-21 10:26:39 +02:00
parent 089684ea00
commit 8c7c802c06
2 changed files with 26 additions and 24 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
LICENSE
View File

@ -1,6 +1,6 @@
The MIT License (MIT) The MIT License (MIT)
Copyright (c) 2015 amphp Copyright (c) 2015-2017 amphp
Permission is hereby granted, free of charge, to any person obtaining a copy Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal of this software and associated documentation files (the "Software"), to deal

48
README.md
View File

@ -2,35 +2,37 @@
[![Build Status](https://img.shields.io/travis/amphp/file/master.svg?style=flat-square)](https://travis-ci.org/amphp/file) [![Build Status](https://img.shields.io/travis/amphp/file/master.svg?style=flat-square)](https://travis-ci.org/amphp/file)
[![CoverageStatus](https://img.shields.io/coveralls/amphp/file/master.svg?style=flat-square)](https://coveralls.io/github/amphp/file?branch=master) [![CoverageStatus](https://img.shields.io/coveralls/amphp/file/master.svg?style=flat-square)](https://coveralls.io/github/amphp/file?branch=master)
![Unstable](https://img.shields.io/badge/api-unstable-orange.svg?style=flat-square) ![Stable](https://img.shields.io/badge/v0.2-stable-orange.svg?style=flat-square)
![License](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square) ![License](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)
`amphp/file` allows non-blocking access to the filesystem for [Amp](https://github.com/amphp/amp).
`amphp/file` is a non-blocking filesystem library for use with the [`amp`](https://github.com/amphp/amp) ## Installation
concurrency framework.
**Dependencies** This package can be installed as a [Composer](https://getcomposer.org/) dependency.
- PHP 5.5+
- [eio](https://pecl.php.net/package/eio)
- [php-uv](https://github.com/bwoebi/php-uv) (experimental, requires PHP7)
`amphp/file` works out of the box without any PHP extensions but it does so using
blocking functions. This capability only exists to simplify development across
environments where extensions may not be present. Using `amphp/file` in production
without pecl/eio or php-uv is **NOT** recommended.
**Current Version**
`amphp/file` is currently pre-alpha software and has no tagged releases. Your mileage may vary.
**Installation**
```bash ```bash
$ composer require amphp/file:dev-master composer require amphp/file
``` ```
**TODO** ## Optional Extension Backends
- seek/read/write to/from specific offsets on open file handles Extensions allow to use threading in the background instead of using multiple processes.
- expose API for receiving notifications when files/directories are modified
- [eio](https://pecl.php.net/package/eio)
- [php-uv](https://github.com/bwoebi/php-uv)
- [pthreads](https://github.com/krakjoe/pthreads)
`amphp/file` works out of the box without any PHP extensions. It uses multi-processing by default, but also comes with a blocking driver that just uses PHP's blocking functions in the current process.
## Versioning
`amphp/file` follows the [semver](http://semver.org/) semantic versioning specification like all other `amphp` packages.
## Security
If you discover any security related issues, please email [`me@kelunik.com`](mailto:me@kelunik.com) instead of using the issue tracker.
## License
The MIT License (MIT). Please see [`LICENSE`](./LICENSE) for more information.