Added new method `put` to the Filesystem class.

Fixed one wrong test against `write`.
Fixed some phpDoc.
[Readme] Added example of `put`.