Doc #79610 [Fbk->Opn]: HTTP PUT description inadequate

Edit report at https://bugs.php.net/bug.php?id=79610&edit=1 ID: 79610 User updated by: denk at us dot es Reported by: denk at us dot es Summary: HTTP PUT description inadequate -Status: Feedback +Status: Open Type: Documentation Problem Package: Documentation problem Operating System: Linux PHP Version: 7.4.6 Block user comment: N Private report: N New Comment: I am sorry I probably did not express this correctly. I'll try again. This page is in the context of file uploads, but the title is just "PUT method support". If you come here because you googled "php put support" (as I did) you could think you are reading about how "put" is supported in php. Also, this seems to be the only page in the manual talking about PUT. Maybe there should be some page in the manual about how to use the different HTTP verbs with PHP, having in mind that REST apis usually use GET, PUT, POST and DELETE. But even without such a page the manual page https://php.net/features.file-upload.put-method could be rewritten along the lines of Title: PUT method support for file uploads For file uploads, some clients use the HTTP PUT (refer to above mentioned "HTTP verbs with PHP" doc) method to upload files with a simple request like this .... ... I think this manual page should make clearer that it refers to a specific application of PUT to upload a file, but that PUT generally is used to update (or create) a _resource_, which does not have to be a file. If there was a more general page about HTTP verbs with PHP it could link to that page. Previous Comments: ------------------------------------------------------------------------ [2020-05-18 12:26:41] requinix@php.net I don't follow. What's wrong with that page? What would you change? ------------------------------------------------------------------------ [2020-05-18 08:16:26] denk at us dot es Description: ------------ --- From manual page: https://php.net/features.file-upload.put-method --- The manual page states: PHP provides support for the HTTP PUT method used by some clients to store files on a server. PUT requests are much simpler than a file upload using POST requests and they look something like this: .... This is certainly not close to the PUT definition for HTTP and restricts the usage of PUT to a very special case. I think this should be corrected in the manual. ------------------------------------------------------------------------ -- Edit this bug report at https://bugs.php.net/bug.php?id=79610&edit=1