Comments (12)
@mattsah Send a pull request, and we can evaluate!
from zend-diactoros.
from zend-diactoros.
@weierophinney
The pull request do not pay attention to the different behaviour:
Psr\Http\Message\StreamInterface
defines the method getSize()
with a return value of ?int
and SplFileInfo::getSize
with int
. And additionally SplFileInfo::getSize
: "An exception is thrown if the file does not exist or an error occurs."
Long story short: ?int
vs. int
and exception
Reference:
- https://www.php-fig.org/psr/psr-7/#36-psrhttpmessageuploadedfileinterface
- https://www.php.net/manual/en/splfileinfo.getsize.php
from zend-diactoros.
Another notice from @michalbundyra: (https://3v4l.org/DnSXf)
class A {
public function getSize(): int {
return 2;
}
}
class B extends A {
public function getSize(): ?int
{
return null;
}
}
$b = new B;
var_dump($b->getSize());
This results in:
Fatal error: Declaration of B::getSize(): ?int must be compatible with A::getSize(): in
At the moment SplFileInfo
does not define an explicit return type for getSize
method but it could become a problem in the future.
from zend-diactoros.
I'm not sure I understand the first point regarding StreamInterface. That is, I don't see the relevance with respect to UploadedFile. UploadedFile appears to return ?int (from your own link), null if unknown. If a stream is passed to UploadedFile, even if it called getSize() directly on the stream, if the return typeof that is always ?int, then it falls within the appropriate return type for UplaodedFile.
Regarding SplFileInfo. Per PSR-7 spec, the getSize() is intended to return the size as actually transferred:
* Implementations SHOULD return the value stored in the "size" key of
* the file in the $_FILES array if available, as PHP calculates this based
* on the actual size transmitted.
Assuming this is accurate, the size transferred, could always be 0 or > 0 -- which means, while UploadedFile may not throw an exception the same as SplFileInfo, it will always report the actual size of an uploaded file... which just happens to be 0 in the event of failure or if not reported by SAPI.
I think the case I'm not understanding is where UploadedFile::getSize() would return NULL -- this would certainly conflict with SplFileInfo. But under what condition does this occur?
In either case, neither UploadedFile or SplFileInfo actually typehint return. If PHP is willing to break backwards compatibility, I'd think all bets are off for libraries and you're in a position to address BC breaks regardless. If PSR-7 changes the actual programmatic interface, presumably that would require a potentially significant update anyway, including requiring newer versions of PHP.
from zend-diactoros.
I have raised other concerns on the related pull request #378 (comment).
from zend-diactoros.
In either case, neither UploadedFile or SplFileInfo actually typehint return. If PHP is willing to break backwards compatibility, I'd think all bets are off for libraries and you're in a position to address BC breaks regardless. If PSR-7 changes the actual programmatic interface, presumably that would require a potentially significant update anyway, including requiring newer versions of PHP.
FIG is actually currently voting on by-laws that will allow adding typehints that conform with the already declared signatures (this would be accomplished via a two-tiered approach to allow libraries to create first a forwards-compatible version, and then break BC to adopt all typehints). As such, libraries that provide implementations MUST follow the specified contract.
from zend-diactoros.
I've submitted a patch to revert the change in #379
from zend-diactoros.
Sure, but adding a typehint of ?int
to getSize()
will not actually cause an issue when extending SplFileInfo as it predates strict interfaces, that is SplFileInfo says it returns int or throws exception, but it does not have a typehint that would require compatibility in the first place and is implicitly a mixed result in terms of actual code.
With respect to other issues raised. SplFileInfo does not go "kaboom" -- it does exactly what it does in any case where the file does not exist as can easily be demonstrated by the following:
matt@havana:~$ php -r "(new SplFileInfo('/tmp/test'))->getMTime();"
PHP Fatal error: Uncaught RuntimeException: SplFileInfo::getMTime(): stat failed for /tmp/test in Command line code:1
Stack trace:
#0 Command line code(1): SplFileInfo->getMTime()
#1 {main}
thrown in Command line code on line 1
SplFileInfo is not intended to only function on existing files. You can add any path you like to it in order to try and grok information. If someone is trying to get the m time of a file they are going to have to make sure the file exists first anyhow using SplFileInfo::isFile() or something similar.
It seems unfortunate that this was reverted for SplFileInfo responding as it should.
from zend-diactoros.
@mattsah SplFileInfo
is meant for file paths (whether they exist or not). It's not meant to be used for stream paths. Treating stream paths as non existent file paths is simply not right (especially when the stream path is valid).
from zend-diactoros.
@ADmad I guess people better stop using rename()
for streams then, since according to the documentation "rename — Renames a file or directory" and a stream is neither of those.
PHP has gone through a long process of progressively adding stream support and stream wrappers to places where previously only normal files could be used. Pointing out that PHP is inconsistent and/or doesn't provide proper/meaningful support for streams in all such places doesn't seem like a very good argument against this feature.
A stream is a non-existent file, because it's not a file... it's a stream.
from zend-diactoros.
This repository has been closed and moved to laminas/laminas-diactoros; a new issue has been opened at laminas/laminas-diactoros#3.
from zend-diactoros.
Related Issues (20)
- Return types inaccurate HOT 5
- ServerRequest: Header with value "0" discarded HOT 6
- Segfault in PHP 7.3.0 when instantiating HtmlResponse in Built-in Web Server HOT 13
- Version 2.0.2 breaks on Apache HOT 5
- get an exeption from ServerRequestFactory::fromGlobals if i make get req without variables HOT 4
- Header error with Docker container usage HOT 12
- ServerRequestFactory::fromGlobals() breaking on windows x64 HOT 3
- UTF-8 URIs are broken by parse_url when locale is set HOT 6
- Empty header check breaking change HOT 4
- Uncaught TypeError: Return value of Zend\\Diactoros\\Uri::filterQueryOrFragment() must be of the type string, null returned HOT 7
- Array cookies not parser properly HOT 1
- marshallHttps incorrectly detects HTtPS-connection
- Generators are not supported for JSON responses. HOT 1
- BUG: marshalHeadersFromSapi assume all SERVER keys are strings HOT 1
- LTS Version 1.7 is missing a security fix HOT 5
- PHP Parse error: syntax error, unexpected '?', expecting variable @ marshal_uri_from_sapi.php on line 83 HOT 7
- PhpInputStream's getSize function is Wrong! HOT 4
- Probably an incorrect test case testAuthorityIsPrefixedByDoubleSlashIfPresent in UriTest.php HOT 1
- PHP Fatal error: require(): Failed opening required zendframework/zend-diactoros/src/functions/create_uploaded_file.php HOT 4
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from zend-diactoros.