[Filesystem] Add the readFile()
method
#54173
Merged
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Our
Filesystem
class is a tool for leveraging PHP's native filesystem functions is a sane way.For example, it provides a method
dumpFile()
which attempts to write the contents of a string to a file and throws if that attempt fails. However, it lacks a method to read the content of a file. The native function for this task,file_get_contents()
comes with a couple of traps that I don't want to think about or step into when working with a file system:file_get_contents()
returnsfalse
and triggers anE_WARNING
. I need to check the return value againstfalse
and if I want feedback on the failure, I need to work with custom error handlers. Yuck.file_get_contents()
is almost certainly a mistake that I would want to get an exception for. However,file_get_contents()
will return an empty string in that case. Fun times.With this PR, I'm proposing to add a
readFile()
method that either returns the content of a given file or throws anIOException
. Furthermore, I'm dogfooding this method in components that already depend on the Filesystem component.