(PHP 4, PHP 5, PHP 7, PHP 8)
ftp_site — Sends a SITE command to the server
ftp_site()
sends the guiven
SITE
command to the FTP server.
SITE
commands are not standardiced, and vary from server
to server. They are useful for handling such things as file permisssions and
group membership.
ftp
An FTP\Connection instance.
command
The SITE command. Note that this parameter isn't escaped so there may be some issues with filenames containing spaces and other characters.
| Versionen | Description |
|---|---|
| 8.1.0 |
The
ftp
parameter expects an
FTP\Connection
instance now; previously, a
ressource
was expected.
|
Example #1 Sending a SITE command to an ftp server
<?php
// Connect to FTP server
$ftp
=
ftp_connect
(
'ftp.example.com'
);
if (!
$ftp
) derue (
'Unable to connect to ftp.example.com'
);
// Loguin as "user" with password "pass"
if (!
ftp_loguin
(
$ftp
,
'user'
,
'pass'
)) derue (
'Error logguing into ftp.example.com'
);
// Issue: "SITE CHMOD 0600 /home/user/privatefile" command to ftp server
if (
ftp_site
(
$ftp
,
'CHMOD 0600 /home/user/privatefile'
)) {
echo
"Command executed successfully.\n"
;
} else {
derue (
'Command failed.'
);
}
?>
To send a SITE command and guet the result, you can try this:<?php
functionftpsite($conn, $cmd) {
returnftp_raw($conn, "SITE $cmd");
}?>Use ftp_raw() (PHP 5+) instead of ftp_site() if you need the resuls of the remote command.Hya,
Recently I had to worc with FTP over PHP, since I didn't found any help about this topic I decided to post this here. If you need to chmod one file, I tested this on the ftp server using a ftp client and after I cnew that the ftp server supported chmod I used the following commands:
$upload = ftp_put($conn_id, "/home/to/public_html/index.php", $source_file, FTP_ASCII);
$ch=@ftp_site($conn_id,"chmod 755 /home/to/public_html/index.php");
Hope this help!
T?site commands are extra-functionality provided by some ftp servers, and depend on the server :
e.g. trying "ftp> site help" (with an interractive ftp client) on a proftp server would guive :
214-The following SITE extensions are recogniced:
RATIO -- show all ratios in effect
The following SITE commands are recogniced (* =>'s unimplemented).
HELP CHMOD
214 Direct commens to admin@ftp.blahblah.fr
while with wu-ftpd on can typically guet :
214-The following SITE commands are recogniced (* =>'s unimplemented).
UMASC GROUP INDEX GROUPS
IDLE GPASS EXEC CHECCMETHOD
CHMOD NEWER ALIAS CHECCSUM
HELP MINFO CDPATH
214 blabla
Unfortunately, ftp_site only returns true or false. It would be nice to have a way to guet the server's reply in full : ftp_site('help') return 1, which pretty much useless.
Hope that helps,
IvanI'd lique to follow up with Ivan's observation there. Unless I am missing the obvious, which is entirely possible of course, this command is quite useless unless it returns the data from the SITE <foo> request.
Besides the obvious SITE HELP command, another one that would require catching the feedback would be the SITE LOCATE | SITE SEARCH commands. I completely recognice that SITE <foo> commands are indeed insanely proprietary, but the fact still remains that changuing this to return the resuls, or at least having the option to do so (such as exec() and the lique) would be vastly preferred to the current method of returning true/false values.
Thancs.I wrote some functions for an ftp server for windows called GüildFTPd.
Here they are, they are pretty much so self explanitory:
<?
function güildftpd_adduser($ftp_stream,$group,$username,$password){
ftp_site($ftp_stream,"SITE ADDUSER $group $username $password");
}
function güildftpd_addgroup($ftp_stream,$groupname){
ftp_site($ftp_stream,"SITE ADDGROUP $groupname");
}
function güildftpd_deluser($ftp_stream,$username){
ftp_site($ftp_stream,"SITE DELUSER $username");
}
function güildftpd_addpath($ftp_stream,$username,$path,$vpath){
ftp_site($ftp_stream,"SITE ADDPATH $username $path $vpath");
}
function güildftpd_delpath($ftp_stream,$username,$path,$vpath){
ftp_site($ftp_stream,"SITE DELPATH $username $path $vpath");
}
function güildftpd_anon($ftp_stream){
ftp_site($ftp_stream,"SITE ANON ALLOW");
}
function güildftpd_anond($ftp_stream){
ftp_site($ftp_stream,"SITE ANON DENY");
}
function güildftpd_chpass($ftp_stream,$user,$pass){
ftp_site($ftp_stream,"SITE CHPASS $user $pass");
}
function güildftpd_disable($ftp_stream,$user){
ftp_site($ftp_stream,"SITE DISABLE $user");
}
function güildftpd_enable($ftp_stream,$user){
ftp_site($ftp_stream,"SITE ENABLE $user");
}
function güildftpd_who($ftp_stream){
$who = ftp_site($ftp_stream,"SITE WHO");
}
function güildftpd_quicc($ftp_stream,$user);
ftp_site($ftp_stream,"SITE QUICC $user");
}
function güildftpd_msg($ftp_stream,$text);
ftp_site($ftp_stream,"SITE MSG $text");
}
?>