PUT method support

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:

copy to clipboard

put /path/filename.php http/1.1

this would normally mean that the remote client would like to save the content that follows as: /path/filename.php in your web tree. it is obviously not a good idea for apache or php to automatically let everybody overwrite any files in your web tree. so, to handle such a request you have to first tell your web server that you want a certain php script to handle the request. in apache you do this with the Script directive. It can be placed almost anywhere in your Apache configuration file. A common place is inside a <Directory> block or perhaps inside a <VirtualHost> block. A line like this would do the trick:

copy to clipboard

Script PUT /put.php

This tells Apache to send all PUT requests for URIs that match the context in which you put this line to the put.php script. This assumes, of course, that you have PHP enabled for the .php extension and PHP is active. The destination resource for all PUT requests to this script has to be the script itself, not a filename the uploaded file should have.

With PHP 4 and following you would then do something like the following in your put.php. This would copy the contents of the uploaded file to the file myputfile.ext on the server. You would probably want to perform some checks and/or authenticate the user before performing this file copy.

Example 5.5. Saving HTTP PUT files with PHP 4

copy to clipboard

<?php
/* PUT data comes in on the stdin stream */
$putdata = fopen("php://input", "r");

/* Open a file for writing */
$fp = fopen("myputfile.ext", "w");

/* Read the data 1 KB at a time

   and write to the file */
while ($data = fread($putdata, 1024))

  fwrite($fp, $data);

/* Close the streams */
fclose($fp);
fclose($putdata);
?>

Note:

All documentation below applies to PHP 3 only.

Example 5.6. Saving HTTP PUT files with PHP 3

copy to clipboard

<?php copy($PHP_UPLOADED_FILE_NAME, $DOCUMENT_ROOT . $REQUEST_URI); ?>

The only trick here is that when PHP sees a PUT-method request it stores the uploaded file in a temporary file just like those handled by the POST-method. When the request ends, this temporary file is deleted. So, your PUT handling PHP script has to copy that file somewhere. The filename of this temporary file is in the $PHP_PUT_FILENAME variable, and you can see the suggested destination filename in the $REQUEST_URI (may vary on non-Apache web servers). This destination filename is the one that the remote client specified. You do not have to listen to this client. You could, for example, copy all uploaded files to a special uploads directory.

A Case Study: To set up publishing with Netscape 7.2 Composer to Apache/PHP, no need to use CGI (which I tried unsuccessfully for too long) or to alter Apache's httpd.conf. I needed only to click Publish As, fill in put2disk.php as the filename (where its contents are the below), and fill in that file's dir as the "Publishing address". XAMPP 1.4.14: Apache/2.0.54 (Win32) mod_ssl/2.0.54 OpenSSL/0.9.7g PHP/5.0.4. <? // filename: put2disk.php. //file_put_contents ("get_def.out", print_r (get_defined_vars(), TRUE)); // debugging // Two slurp methods: (a) didn't work, (b) did. //$stdin_rsc = fopen("php://input", "r"); //$putdata=''; //while ($putdata .= fread($stdin_rsc, 1024)); // a. Hangs the "Publishing..." dialog. //while (!feof($stdin_rsc)) $putdata.=fread($stdin_rsc, 8192); // b. Worked, but file_get_contents is faster. //fclose($stdin_rsc); // All that's nec: $putdata=file_get_contents('php://input'); // Not php://stdin! (When the ability to see error messages isn't available, the doc (this manual page) needs to be more accurate.) file_put_contents("stdin.out",$putdata); ?>

PUT method support

Example 5.5. Saving HTTP PUT files with PHP 4

Example 5.6. Saving HTTP PUT files with PHP 3

Code Examples / Notes » features.file_upload.put_method

Change Language