PHPackages                             axy/fs-real - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File &amp; Storage](/categories/file-storage)
4. /
5. axy/fs-real

ActiveLibrary[File &amp; Storage](/categories/file-storage)

axy/fs-real
===========

File system access

0.0.3(9y ago)0211[4 issues](https://github.com/axypro/fs-real/issues)MITPHPPHP &gt;=5.4.0

Since Apr 1Pushed 8y ago1 watchersCompare

[ Source](https://github.com/axypro/fs-real)[ Packagist](https://packagist.org/packages/axy/fs-real)[ Docs](https://github.com/axypro/fs-real)[ RSS](/packages/axy-fs-real/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (2)Versions (4)Used By (0)

axy\\fs\\real
=============

[](#axyfsreal)

File system access (PHP).

Real implementation of [axy/fs/ifs](https://github.com/axypro/fs-ifs).

[![Latest Stable Version](https://camo.githubusercontent.com/91cf5016f2204ead42da36331dfcd018c78b71400c8a3c2087cf1507dcd1656c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6178792f66732d7265616c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/axy/fs-real)[![Minimum PHP Version](https://camo.githubusercontent.com/b52c83f3d45755ebcb1e6863ebb202ab192aaf773424369ffdeedae107f027ef/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344253230352e342d3838393242462e7376673f7374796c653d666c61742d737175617265)](https://php.net/)[![Build Status](https://camo.githubusercontent.com/a0ed2d452c31a4c035e91d0aeddd851c48b19902fcde36705d4c9faae841bcb0/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f61787970726f2f66732d7265616c2f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/axypro/fs-real)[![Coverage Status](https://camo.githubusercontent.com/cb6aea2659f03d1dcac902ebb98cf5c2aeb9371d4f3ff2e0047dee3fe5c3fdba/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f61787970726f2f66732d7265616c2f62616467652e7376673f6272616e63683d6d617374657226736572766963653d676974687562)](https://coveralls.io/github/axypro/fs-real?branch=master)[![License](https://camo.githubusercontent.com/b6b5172cf684331bbf1d6a6d5b5ba2c049f702cf2ec5165716d3d3f1e119a569/68747470733a2f2f706f7365722e707567782e6f72672f6178792f66732d7265616c2f6c6963656e7365)](LICENSE)

- The library does not require any dependencies.
- Tested on PHP 5.4+, PHP 7, HHVM (on Linux), PHP 5.5 (on Windows).
- Install: `composer require axy/fs-real`.
- License: [MIT](LICENSE).

Documentation
-------------

[](#documentation)

It is an implementation of interfaces from [axy/fs-ifs](https://github.com/axypro/fs-ifs). This implementation works with the real file system.

The class `FS` is implementation of `axy\fs\ifs\IFS`.

`FS::open()` returns an instance of `RealFile` class that is implementation of `axy\fs\ifs\IFile`.

Messages of the `FSError` exception are similar build-in functions WARNINGs.

Bugs
----

[](#bugs)

The library successfully tested on PHP 5.4, 5.5, 5.5 and 7.0 via travis-ci.org.

For HHVM there are several little bugs:

- `copy()` does not throw exception if the source does not exist.
- `$file->getMetaData()` for closed `$file` does not throw an exception.
- If create a file using `createTempFile()` and gets meta data using `$file->getMetaData()` then the file `meta->filename` does not exists.

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~193 days

Total

3

Last Release

3304d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e5b3a2db8d5614167d4510019e3373dbba63c6aade58d38d23f3e7d2e63c3c4a?d=identicon)[axy](/maintainers/axy)

---

Top Contributors

[![vasa-c](https://avatars.githubusercontent.com/u/557081?v=4)](https://github.com/vasa-c "vasa-c (14 commits)")

---

Tags

filedirectoryfile system

### Embed Badge

![Health badge](/badges/axy-fs-real/health.svg)

```
[![Health](https://phpackages.com/badges/axy-fs-real/health.svg)](https://phpackages.com/packages/axy-fs-real)
```

###  Alternatives

[adlawson/vfs

Virtual file system

300433.0k21](/packages/adlawson-vfs)[crysalead/dir

Recursive directory scanner to locate directories and/or files in a file system

13214.5k4](/packages/crysalead-dir)[icecave/temptation

Painless temporary files and directories that clean up after themselves.

129.3k2](/packages/icecave-temptation)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
