Transférer des fichiers par FTP, FTPS et SFTP
La façon la plus courante d’amener les fichiers d’un site sur l’hébergement est de les transférer sur le serveur. Pourquoi ne pas utiliser le FTP simple, en quoi FTPS et SFTP diffèrent, comment transférer des fichiers en ligne de commande et comment se connecter avec une clé SSH au lieu d’un mot de passe.
FTP, FTPS et SFTP
- FTP (port 21) – le protocole le plus ancien. Il envoie le nom d’utilisateur, le mot de passe et les fichiers sans chiffrement, n’importe qui en chemin peut donc les lire. Ne l’utilisez pas.
- FTPS – FTP sécurisé par TLS (comme HTTPS). Le FTPS explicite (explicit) commence sur le port 21 et active le chiffrement par la commande AUTH TLS, l’implicite (implicit) chiffre dès le début sur le port 990. Les hébergeurs proposent plus souvent l’explicite.
- SFTP (port 22) – un tout autre protocole, le transfert de fichiers via SSH. Il n’a en commun avec FTP que le nom. Il utilise le même compte que la connexion SSH et prend en charge la connexion par clé.
FTP et FTPS transfèrent les données par une connexion séparée. En mode passif (par défaut aujourd’hui), c’est le client qui l’ouvre, cela fonctionne donc aussi derrière un pare-feu et un routeur. Si le programme se connecte mais ne charge pas la liste du dossier, le problème vient généralement du mode ou du pare-feu.
Programmes
- WinSCP (Windows) – SFTP, FTP et FTPS, comparaison et synchronisation de dossiers (Commandes → Synchroniser), modification de fichiers directement sur le serveur, scripts.
- FileZilla (Windows, macOS, Linux) – SFTP, FTP et FTPS. Téléchargez l’installateur depuis le site du projet et refusez l’installation des programmes supplémentaires qu’il propose.
- Éditeurs – Visual Studio Code, PhpStorm et d’autres savent transférer des fichiers directement depuis l’éditeur (dans VS Code via une extension).
Les mots de passe enregistrés dans les programmes FTP sont une cible favorite des logiciels malveillants sur l’ordinateur. Là où c’est possible, utilisez SFTP avec une clé (ci-dessous), sinon le mot de passe principal du programme.
Mode de transfert : binaire et ASCII
FTP sait transférer des fichiers en mode ASCII, qui convertit les fins de ligne (CRLF sous Windows, LF sur le serveur). Il endommagerait les fichiers binaires (images, ZIP, PDF). Les programmes choisissent le mode automatiquement selon l’extension ; si des images ou des archives endommagées apparaissent sur le serveur, réglez le mode binaire pour tout. Les fins de ligne du code sont mieux gérées par l’éditeur ou par Git, voir Git sous Windows et sur le serveur. SFTP transfère toujours les fichiers sans modification.
Transfert en ligne de commande : curl et FTPS
Le programme curl (présent dans Windows 10 et 11 et dans Git Bash) prend en charge FTP et FTPS. L’option --ssl-reqd exige le chiffrement – si le serveur ne le propose pas, curl coupe la connexion au lieu d’envoyer le mot de passe en clair. Sans mot de passe dans l’option --user, curl le demande :
curl --ssl-reqd --user jean -T index.php ftp://ftp.example.com/www/ curl --ssl-reqd --user jean --ftp-create-dirs -T css/style.css ftp://ftp.example.com/www/css/ curl --ssl-reqd --user jean --list-only ftp://ftp.example.com/www/
css index.php
- -T transfère un fichier ; une adresse terminée par une barre oblique = dans ce dossier sous le même nom.
- --ftp-create-dirs crée les dossiers manquants sur le serveur.
- --list-only affiche seulement les noms des fichiers du dossier.
- Téléchargement : curl --ssl-reqd --user jean -o index.php ftp://ftp.example.com/www/index.php.
Curl vérifie le certificat du serveur FTPS comme pour HTTPS. Si le serveur a un certificat pour un autre nom (par exemple le nom commun du serveur de l’hébergeur), utilisez ce nom dans l’adresse et non l’option --insecure, qui désactive la vérification.
Clé SSH au lieu du mot de passe
Pour SFTP et SSH, une clé SSH est plus sûre et plus pratique : une paire composée de la clé privée (elle reste sur votre ordinateur) et de la clé publique (elle va sur le serveur). Une clé ne se devine pas et ne s’intercepte pas comme un mot de passe. Dans Git Bash, vous la créez avec la commande :
ssh-keygen -t ed25519 -C "jean.dupont@laptop"
Le programme demande où enregistrer la clé (par défaut ~/.ssh/id_ed25519, confirmez avec Entrée) et un mot de passe pour la clé (passphrase). Le mot de passe protège la clé si le fichier tombe entre de mauvaises mains – nous recommandons d’en définir un. Deux fichiers sont créés : id_ed25519 (la clé privée, ne la transmettez jamais à personne) et id_ed25519.pub (la clé publique). Collez le contenu de la clé publique – une ligne qui commence par ssh-ed25519 – dans le panneau d’administration de l’hébergeur, à la rubrique des clés SSH, ou sur le serveur dans une nouvelle ligne du fichier ~/.ssh/authorized_keys.
Pour ne pas saisir sans cesse l’adresse, le nom d’utilisateur et le port, enregistrez-les dans le fichier ~/.ssh/config (dans Git Bash, ~ est votre dossier utilisateur, par exemple C:\Users\Jean) :
Host example HostName example.com User jean Port 22 IdentityFile ~/.ssh/id_ed25519
Ensuite, il suffit de ssh example, sftp example ou scp … example:. À la première connexion, SSH demande si vous faites confiance au serveur et affiche l’empreinte de sa clé – comparez-la avec l’empreinte indiquée par l’hébergeur et répondez yes. La clé du serveur est enregistrée dans ~/.ssh/known_hosts et, la fois suivante, SSH la vérifie lui-même. N’ignorez pas l’avertissement indiquant que la clé du serveur a changé : soit l’hébergeur a remplacé le serveur (demandez-lui), soit quelqu’un s’est placé entre vous et le serveur.
SFTP en ligne de commande
Le programme sftp (dans Git Bash et dans Windows 10 et 11) fonctionne de façon interactive ou exécute les commandes d’un fichier. Le fichier upload.txt :
cd www put index.php put -r css chmod 644 index.php ls -1
sftp -b upload.txt example
sftp> cd www sftp> put index.php sftp> put -r css Entering css/ sftp> chmod 644 index.php sftp> ls -1 css index.php
L’option -b (batch) s’arrête à la première erreur. put -r transfère un dossier avec son contenu, get télécharge, mkdir, rm et rename modifient les fichiers sur le serveur. En mode batch, il est impossible de demander le mot de passe, il faut donc une clé SSH.
Le programme scp copie comme la commande cp, sauf qu’un des côtés est sur le serveur (depuis OpenSSH 9, il utilise le même protocole que SFTP) :
scp index.php example:www/ scp -r css example:www/ scp example:www/index.php backup-index.php
Un chemin après les deux-points sans barre oblique au début est relatif au dossier de l’utilisateur sur le serveur. Le port s’indique dans sftp et scp avec un -P majuscule, dans ssh avec un -p minuscule – avec les réglages dans ~/.ssh/config, vous n’avez pas besoin de l’écrire.
Ce qu’il ne faut pas mettre sur le serveur
- le dossier .git ni les fichiers .gitignore et .gitattributes (voir Git sous Windows et sur le serveur) ;
- la configuration locale avec les accès à la base de données locale – le serveur a son propre .env ou fichier de configuration, qu’il ne faut pas écraser lors du transfert (voir Mots de passe et clés dans un fichier .env) ;
- les sauvegardes de la base de données (*.sql), les archives du site et les sorties de phpinfo() – dans le dossier du site, quiconque devine le nom peut les télécharger ;
- les dossiers sources des outils (node_modules, styles non compilés), si le site n’en a pas besoin.
Droits des fichiers
Sur un serveur Linux, les fichiers ont des droits : en général 644 pour les fichiers (le propriétaire lit et écrit, les autres lisent seulement) et 755 pour les dossiers. Vous les modifiez avec la commande chmod dans SFTP ou dans les propriétés du fichier dans WinSCP et FileZilla. Ne mettez pas les droits 777 (écriture pour tous) – si le site doit écrire dans un dossier (photos envoyées, cache), demandez à l’hébergeur quels droits y suffisent. Les fichiers contenant des mots de passe peuvent avoir 600 ou 640.
Ordre du transfert
Lors d’un transfert fichier par fichier, le site se compose un moment d’anciens et de nouveaux fichiers. Pour une petite modification, ce n’est pas grave. Pour une plus grande, transférez d’abord les nouveaux fichiers que rien n’utilise encore (bibliothèques, nouveaux modèles) et seulement à la fin les fichiers qui commenceront à les utiliser. En cas de modification de la base de données ou de toute la structure, activez un instant le mode maintenance (503). L’article Déploiement via Git et SSH montre comment se passer complètement du transfert de fichiers et tout déployer d’un coup.
Articles connexes :
Git sous Windows et sur le serveur
Fichiers à exclure du dépôt
Mots de passe et clés dans un fichier .env
Déploiement via Git et SSH