From:
Operating system: Fedora 13
PHP version: 5.3.3
Package: FTP related
Bug Type: Feature/Change Request
Bug description:FTP need the ability to read from the output buffer without
issuing a command
Description:
------------
Working with ftp_raw there is a need for a function that allows interaction
with
the output buffer of the connection. There are times when issuing commands
leaves messages on the buffer thereby causing future commands to be out of
sync
with the output and no way to synchronize them. Below is an example:
Using HylaFax's proprietary ftp interface I required the ability to issue a
'STOT' command.
I issued a 'PASV' command to get the appropriate port to open a second
connection to. I open a second connection, write a file, then close it.
The original connection now has a line on the output buffer similar to
this:
226 Transfer complete (FILE: /tmp/doc94274.tmp)
But there is no way to grab this.
Issuing any command will return the buffered line. Subsequent commands
will
return the output of the previous command.
For example if I now issue a 'NOOP' I will now get the:
226 Transfer complete (FILE: /tmp/doc94274.tmp).
and If I issue a second 'NOOP' I will get the response from the orginal
'NOOP':
200 NOOP command successful
With the second Noop now sitting on the out buffer of the ftp connection.
Test script:
---------------
<?php
/**
* This example will require the use of a HylaFax Server with the -i
option
* enabled.
*/
$fileName = '/foo/test.pdf';
$hylaFaxServer = 'localhost';
$user = 'Mr. Peters';
function getResultCode( $resultString )
{
$resultCode = false;
if( strpos($resultString, ' ') > 2) {
$resultCode = substr($resultString, 0, strpos($resultString, '
' )
);
return $resultCode;
}
return $resultCode;
}
function getResultToString( $resultArray, $glue = "\n" )
{
if ( is_array( $resultArray ) ) {
return implode($resultArray, $glue );
}
return false;
}
function sendFile( $localFileName, $connection, $hostName )
{
//Enter PASV mode
if($results = getResultToString( ftp_raw($connection, 'PASV') )) {
//Make sure we got the appropriate 227 back
if(getResultCode( $results ) == 227) {
//Grab the ip and ports out of the response
$ports = substr($results, strpos($results, '(')+1 ) ;
//get rid of the extra ')' as the end
$ports = substr($ports, 0, strlen($ports) - 1);
//make an array of the results using the ',' as the
seporator
$ports = explode(",", $ports);
//grab the last octet
$lastOctet = array_pop($ports);
//grab the first octet
$firstOctet = array_pop($ports);
//deduce the appropriate port to connect back to
$port = $firstOctet * 256 + $lastOctet;
//create a connection to listen on
if( $passiveSocket = fsockopen( $hostName, $port) ) {
//Tell the ftp server to make a connection
if($results = getResultToString(ftp_raw( $connection,
'STOT' ) ) ) {
//make sure the connection was successful
if(getResultCode($results) == 150) {
//Write the file over the new socket
if( fwrite( $passiveSocket, $localFileName ) )
{
//Close the socket
if(fclose( $passiveSocket ) ) {
$results = getResultToString( ftp_raw(
$connection, 'STAT' ) );
echo "Results of stat:\n";
echo $results;
echo "Results of Noop:\n";
$results = getResultToString( ftp_raw(
$connection, 'noop' ) );
echo $results;
} // socket closure
} //file writing
} //result of STOT command to first socket
} else { //issue the STOT Command to first socket
echo 'Unexpected result from STOR: ';
var_dump( $results )."\n";
}
} //Attempt to open second socket on local machine
} else { //Unexpected resultcode from pasv command
echo 'Unexpected result code from passive mode:
'.getResultCode ($results );
} // review result code from PASV command
return true;
} //Attempt to send PASV command to connection
return false;
}
function output(&$item, $key) {
echo $item."\n";
}
$connection = ftp_connect($hylaFaxServer , '4559');
array_walk( ftp_raw($connection, 'USER '.$user), 'output' );
array_walk( ftp_raw($connection, 'FORM PDF'), 'output' );
array_walk( ftp_raw($connection, 'TYPE I'), 'output' );
$uploadedFileName = sendFile($fileName, $connection, $hylaFaxServer);
array_walk( ftp_raw($connection, 'JNEW'), 'output' );
array_walk( ftp_raw($connection, 'JPARM FROMUSER "'.$user.'"'),
'output' );
array_walk( ftp_raw($connection, 'JPARM LASTTIME 000259'), 'output' );
array_walk( ftp_raw($connection, 'JPARM MAXDIALS 12'), 'output' );
array_walk( ftp_raw($connection, 'JPARM MAXTRIES 3'), 'output' );
array_walk( ftp_raw($connection, 'JPARM SCHEDPRI 127'), 'output' );
array_walk( ftp_raw($connection, 'JPARM DIALSTRING "3340746"'),
'output' );
array_walk( ftp_raw($connection, 'JPARM NOTIFYADDR
"[email protected]"'), 'output' );
array_walk( ftp_raw($connection, 'JPARM VRES 196'), 'output' );
array_walk( ftp_raw($connection, 'JPARM PAGEWIDTH 215'), 'output' );
array_walk( ftp_raw($connection, 'JPARM PAGELENGTH 279'), 'output' );
array_walk( ftp_raw($connection, 'JPARM NOTIFY "none"'), 'output' );
array_walk( ftp_raw($connection, 'JPARM PAGECHOP "none"'), 'output' );
array_walk( ftp_raw($connection, 'JPARM CHOPTHRESHOLD 3'), 'output' );
array_walk( ftp_raw($connection, 'JPARM DOCUMENT '.$uploadedFileName ),
'output' );
array_walk( ftp_raw($connection, 'JSUBM'), 'output' );
ftp_close($connection);
?>
Expected result:
----------------
230 User Mr. Peters logged in.
200 Format set to PDF.
200 Type set to Image.
226 Transfer complete (FILE: /tmp/doc96.pdf).
Results of stat:
211-samadams.northrock.local HylaFAX server status:
HylaFAX (tm) Version 5.4.2
Connected to localhost.localdomain (127.0.0.1)
Logged in as user Mr. Peters (uid 60002)
"/" is the current directory
Current job: (default)
Time values are handled in GMT
Idle timeout set to 900 seconds
Using long replies
No server down time currently scheduled
HylaFAX scheduler reached at /FIFO (not connected)
Server FIFO is /client/26610 (open)
File cache: 17 lookups, 1 hits (5.9%), 1.1 avg probes
16 entries (2.9 KB), 0 entries displaced, 0 entries flushed
TYPE: Image; STRU: File; MODE: Stream; FORM: PDF
No client data connection
211 End of status
Results of Noop:
200 NOOP command successful.
200 New job created: jobid: 73 groupid: 73.
213 FROMUSER set to "Mr. Peters".
213 LASTTIME set to 000259.
213 MAXDIALS set to 12.
213 MAXTRIES set to 3.
213 SCHEDPRI set to 127.
213 DIALSTRING set to "3340746".
213 NOTIFYADDR set to "[email protected]".
213 VRES set to 196.
213 PAGEWIDTH set to 215.
213 PAGELENGTH set to 279.
213 NOTIFY set to "none".
213 PAGECHOP set to "none".
213 CHOPTHRESHOLD set to 3.
550 1: No such file or directory.
Actual result:
--------------
230 User Mr. Peters logged in.
200 Format set to PDF.
200 Type set to Image.
Results of stat:
226 Transfer complete (FILE: /tmp/doc96.pdf).Results of Noop:
211-samadams.northrock.local HylaFAX server status:
HylaFAX (tm) Version 5.4.2
Connected to localhost.localdomain (127.0.0.1)
Logged in as user Mr. Peters (uid 60002)
"/" is the current directory
Current job: (default)
Time values are handled in GMT
Idle timeout set to 900 seconds
Using long replies
No server down time currently scheduled
HylaFAX scheduler reached at /FIFO (not connected)
Server FIFO is /client/26610 (open)
File cache: 17 lookups, 1 hits (5.9%), 1.1 avg probes
16 entries (2.9 KB), 0 entries displaced, 0 entries flushed
TYPE: Image; STRU: File; MODE: Stream; FORM: PDF
No client data connection
211 End of status200 NOOP command successful.
200 New job created: jobid: 73 groupid: 73.
213 FROMUSER set to "Mr. Peters".
213 LASTTIME set to 000259.
213 MAXDIALS set to 12.
213 MAXTRIES set to 3.
213 SCHEDPRI set to 127.
213 DIALSTRING set to "3340746".
213 NOTIFYADDR set to "[email protected]".
213 VRES set to 196.
213 PAGEWIDTH set to 215.
213 PAGELENGTH set to 279.
213 NOTIFY set to "none".
213 PAGECHOP set to "none".
213 CHOPTHRESHOLD set to 3.
550 1: No such file or directory.
--
Edit bug report at http://bugs.php.net/bug.php?id=52766&edit=1
--
Try a snapshot (PHP 5.2):
http://bugs.php.net/fix.php?id=52766&r=trysnapshot52
Try a snapshot (PHP 5.3):
http://bugs.php.net/fix.php?id=52766&r=trysnapshot53
Try a snapshot (trunk):
http://bugs.php.net/fix.php?id=52766&r=trysnapshottrunk
Fixed in SVN:
http://bugs.php.net/fix.php?id=52766&r=fixed
Fixed in SVN and need be documented:
http://bugs.php.net/fix.php?id=52766&r=needdocs
Fixed in release:
http://bugs.php.net/fix.php?id=52766&r=alreadyfixed
Need backtrace:
http://bugs.php.net/fix.php?id=52766&r=needtrace
Need Reproduce Script:
http://bugs.php.net/fix.php?id=52766&r=needscript
Try newer version:
http://bugs.php.net/fix.php?id=52766&r=oldversion
Not developer issue:
http://bugs.php.net/fix.php?id=52766&r=support
Expected behavior:
http://bugs.php.net/fix.php?id=52766&r=notwrong
Not enough info:
http://bugs.php.net/fix.php?id=52766&r=notenoughinfo
Submitted twice:
http://bugs.php.net/fix.php?id=52766&r=submittedtwice
register_globals:
http://bugs.php.net/fix.php?id=52766&r=globals
PHP 4 support discontinued: http://bugs.php.net/fix.php?id=52766&r=php4
Daylight Savings: http://bugs.php.net/fix.php?id=52766&r=dst
IIS Stability:
http://bugs.php.net/fix.php?id=52766&r=isapi
Install GNU Sed:
http://bugs.php.net/fix.php?id=52766&r=gnused
Floating point limitations:
http://bugs.php.net/fix.php?id=52766&r=float
No Zend Extensions:
http://bugs.php.net/fix.php?id=52766&r=nozend
MySQL Configuration Error:
http://bugs.php.net/fix.php?id=52766&r=mysqlcfg
