Comments (36)
The automatic wontfix label makes me 😢
from zend-diactoros.
Unless you have suggestions, we're not likely to change the name at this point. We couldn't name it "http" for obvious reasons, "HttpMessage" would never return relevant results, and "Hermes" or "Mercury" are already flooded with results. We briefly considered "zttp" or "zhttp", but ultimately ruled them out.
The criteria we have:
- cannot conflict with existing ZF component names
- cannot conflict with existing php project/company names
- should have some affinity with either http or messaging
- should be unique enough to rise to the top of search results
I'll gladly consider names that fulfill those criteria, but the name will need to be quite compelling to trigger a rename at this point.
from zend-diactoros.
I get that - I'm actually not trying to be argumentative (for once). Personally I just feel that a non-unique descriptive name trumps Googlability.
from zend-diactoros.
It's not just about search; part of this is about being able to track reach. As an example, ZF often appears to trend lower than other frameworks, while simultaneously having more downloads. The reason is interesting: two words in the name, one common, and the other a brand shared amongst several products skews to lower search ranking, which makes understanding our reach difficult.
Hence, the argument for something more unique. :-)
from zend-diactoros.
I get that, it feel so pretentious, I just hate this name.
from zend-diactoros.
Agree with GeeH, at the beginning I kept forgetting how it is spelled :)
Difficult name won't help with getting more reach.
from zend-diactoros.
Why can't it just be Zend\Http 3.0?
from zend-diactoros.
zend-psr7
from zend-diactoros.
Zend\Http clearly doesn't meet the requirements set out above.
from zend-diactoros.
Obviously, but my question is why Zend\Http 3.x can't be the PSR-7 implementation? Surely this is exactly the kind of thing that the repositories were split for?
from zend-diactoros.
why Zend\Http 3.x can't be the PSR-7 implementation? Surely this is exactly the kind of thing that the repositories were split for?
Yes and no.
In this case, the architecture of Zend\Http
is radically different than a PSR-7 implementation:
- it provides a client implementation
- it provides concrete header implementations
- it provides a cookie-jar implementation
PSR-7 support is around just the messages; all of the above are out-of-scope for a PSR-7 implementation. They are instead utilities that would consume a PSR-7 implementation at this point
As such, calling this Zend\Http
3.0 would mean either (a) dropping all of that support, or require a ton of refactoring/new development to get to feature parity. This would mean we would not have a stable PSR-7 implementation for some months, vs having something that works immediately, which is what this library does.
The next consideration is one of migration. The APIs in zend-http and PSR-7 are radically different; in fact, the underlying interfaces themselves have several methods in common, but with differing signatures, making bridging them a bit of a task as well. If we consider that we want to keep the current ZF2 MVC intact for those wanting the more flexible, structured approach it provides, replacing zend-http with this library makes no sense. Those developers then have no migration path, in part because they cannot have a PSR-7 library that can work in parallel with zend-http; they have to go all-or-nothing.
By having this library separate from zend-http, we provide a migration path, and we can also defer decisions such as "should ZF offer an HTTP client? should ZF offer concrete header utilities? if so, how?" to later, while providing a PSR-7 library now.
from zend-diactoros.
zend-psr7
No. This is far too generic to be useful when searching for a PSR-7 implementation.
from zend-diactoros.
I'm going to point out one more thing: the fact that the name is currently polarizing also tells me it's likely a good choice. If my tenure doing OSS has taught me anything, any attention is typically good for increasing visibility.
from zend-diactoros.
Not sure why "diactoros" is being bashed this much.
Is a non-english name that hard to remember? (note that I still don't know
how "Gary" is pronounced in welsh :-P )
Marco Pivetta
On 25 May 2015 at 19:50, weierophinney [email protected] wrote:
zend-psr7
No. This is far too generic to be useful when searching for a PSR-7
implementation.—
Reply to this email directly or view it on GitHub
#17 (comment)
.
from zend-diactoros.
I'm not a fan because it's not immediately obvious what the library does (or even what broader category it belongs in). @weierophinney makes some very good points defending the name, but at the end of the day I hate it.
I'm entitled to an opinion, just as everyone else is entitled to ignore it. Realistically, the name isn't actually that important.
I prefer it to sit under the Zend\Http\Message
namespace, or even be called Zend\HttpMessage
.
In this instance I may be wrong; it's happened once before in 1997.
from zend-diactoros.
I'm happy with @weierophinney's reasoning. I just struggle with a name I can't pronounce or spell and hence is easily forgotten. I worry that it limits the chance of it being talked about as a result.
shrugs
from zend-diactoros.
I appreciate @weierophinney's reasoning as well. It seems sound, and very well thought out. I'd not fully considered the point about traceability in search results, and see that it's definitely easier to know how good the uptake is, when approached from that perspective. On reading that, I'm ok to go along with it. @Ocramius point about "just because it's not English" is a good one as well. That being said, I still find the name quirky, and feel there could be better choices. However, that opinion being voiced, I'm good with the rationale. Thanks for sharing @weierophinney.
from zend-diactoros.
Hard to remember, and spell but good to say go to github.com
zendframework
repo and look ;) .
from zend-diactoros.
Sorry Hari, I have no idea what point you are trying to make.
Gary
On 26 May 2015, at 08:49, Hari K T [email protected] wrote:
Hard to remember, and spell but good to say go to github.com zendframework repo and look ;) .
—
Reply to this email directly or view it on GitHub #17 (comment).
from zend-diactoros.
Maybe for the future Zend\Http 3.* can use Zend\Diactoros to manage Http\Request and Http\Response and other shared points..
Or Zend\Mvc 3.* will use Zedn\Diactoros and Zend\Http will be only another old componenet..
Is it useless maintain two http layer? Maybe yes..
from zend-diactoros.
@GeeH Names don't always refer to what they do very clearly: Symfony, Mockery, Guzzle, Doctrine, Laravel, Twig, Humbug, etc. The only problem, if it even qualifies, is that it's slightly more challenging in the pronunciation sense being derived from Greek versus more familiar English phrases.
from zend-diactoros.
A lot of those have meaning, Mockery mocks shit etc.
On 26 May 2015, at 09:31, Pádraic Brady [email protected] wrote:
@GeeH https://github.com/GeeH Names don't always refer to what they do very clearly: Symfony, Mockery, Guzzle, Doctrine, Laravel, Twig, Humbug, etc. The only problem, if it even qualifies, is that it's slightly more challenging in the pronunciation sense being derived from Greek versus more familiar English phrases.
—
Reply to this email directly or view it on GitHub #17 (comment).
from zend-diactoros.
@GeeH what I was trying to say was diactoros is hard to remember name.
But as we know there is a package in zend framework we can go and look the name when ever needed.
from zend-diactoros.
Yeah, it’s fine when your at your desk, but when I am talking to someone in person and I have to say “that package, Dia-something, you’ll have to Google it” - it’s not so good.
G
On 26 May 2015, at 10:22, Hari K T [email protected] wrote:
@GeeH https://github.com/GeeH what I was trying to say was diactoros is hard to remember name.
But as we know there is a package in zend framework we can go and look the name when ever needed.
—
Reply to this email directly or view it on GitHub #17 (comment).
from zend-diactoros.
Small experiment. I opened those repos last about 4 days ago.
So, we have zend-diactoros(yes, i had too look at address bar to check how to spell it) and that other thing, something like apigility
but not.
If there will be framework full of those, i will not be happy. Especially if i will need to remember bunch of those namespaces, read and type them a lot.
That is my only complaint for those catchy names.
from zend-diactoros.
I still find the name quirky, and feel there could be better choices
As I noted earlier, I'm fine with changing the name if folks can brainstorm ideas that fit the criteria I outlined in my original comment to this issue, and which have general consensus from others. I and others struggled. I really, really wanted "Hermes", which I think would have been quite accepted, but there are already PHP projects with that name, and Zend even has a customer with that name. :-(
from zend-diactoros.
If there will be framework full of those, i will not be happy. Especially if i will need to remember bunch of those namespaces, read and type them a lot.
Well, the nice part is that you typically only have to type them once per class file, if that. Many times, you'll be type-hinting on the PSR-7 interfaces anyways, which means it will be unusual to need to import the diactoros namespace anyways.
But… noted. We're not planning on renaming existing components, and the two new components were ones we wanted to create differentiation around specifically. I'll keep the creative naming to a minimum.
from zend-diactoros.
zend-diactor
? :-)
from zend-diactoros.
Given the way this discussion has gone, I propose Zend\Dictator :D :D :D
On 26 May 2015, at 14:01, Mateusz Tymek [email protected] wrote:
zend-diactor? :-)
—
Reply to this email directly or view it on GitHub #17 (comment).
from zend-diactoros.
In earnest, if the names did carry more cognitive meaning, perhaps rolled off the tongue more easily, and combined innovativeness with descriptiveness, they might gain better traction. Or, perhaps, a theme to run through them, rather like Ubuntu releases. Though this might not be practical. However, I want to give some genuine constructive input.
from zend-diactoros.
I'm rather partial to Norse gods myself.
from zend-diactoros.
Pretty sure zend-harbinger would be free. Just saying. ;) It is actually hard to find words around messages that are not too ordinary or already taken. There's even a PHP-Herald vendor on Packagist.
from zend-diactoros.
What about changing the first letter of what any package does to Z. Easy to remember and figure out what everything does then. Zend Zessage. This would work for everything, trackable, and doesn't require anyone to be clever.
from zend-diactoros.
Going through the list this could probably name all of them uniquely easily and keep with Zend as a brand.
zend-zime
zend-zalidator
zend-zest
zend-zersion
etc....
from zend-diactoros.
I think diactoros is a good choice. Like @weierophinney already mentioned it has a high WTF factor. Today I've asked my greek colleage if he know what it means. So people start talking about it :-)
Just my two cent
from zend-diactoros.
I sense Zend-Diactoros will be the new T_PAAMAYIM_NEKUDOTAYIM in PHPub Quizzes' questions, which basically gives all the credit to the reasoning behind its name.
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
- Can UploadedFile extend SplFileInfo ? HOT 12
- 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.