Comment obtenir facilement la liste de fichiers sur le serveur FTP à l'aide de la fonction FTP_NList?

M66 2025-07-10

Dans PHP, FTP_NList est une fonction très utile qui peut nous aider à obtenir facilement la liste des fichiers et répertoires des répertoires spécifiés sur le serveur FTP. Il peut être utilisé pour vérifier le contenu du fichier sur le serveur FTP, ce qui nous permet de réaliser des opérations de fichiers, telles que le téléchargement, la suppression ou le téléchargement de fichiers. Aujourd'hui, nous allons approfondir comment utiliser cette fonction et montrer un exemple simple pour vous aider à démarrer rapidement.

Introduction à la fonction ftp_nlist

La fonction FTP_NList est utilisée pour obtenir les noms des fichiers et répertoires dans le répertoire spécifié sur le serveur FTP. Cette fonction renvoie un tableau contenant des noms de fichiers. Notez qu'il répertoriera uniquement les fichiers ou les répertoires dans le répertoire actuel et ne répertoriera pas le contenu dans le sous-répertoire.

Prototype de fonction:

 <span><span><span class="hljs-keyword">array</span></span><span> </span><span><span class="hljs-title function_ invoke__">ftp_nlist</span></span><span> ( resource </span><span><span class="hljs-variable">$ftp_stream</span></span><span> , </span><span><span class="hljs-keyword">string</span></span><span> </span><span><span class="hljs-variable">$directory</span></span><span> )
</span></span>

$ ftp_stream : la ressource pour les connexions FTP, généralement obtenue via ftp_connect ou ftp_login .
$ répertoire : le répertoire pour obtenir la liste de fichiers, qui peut être un chemin relatif ou un chemin absolu.

Valeur de retour:

Cette fonction renvoie un tableau contenant tous les fichiers et noms de répertoire dans le répertoire spécifié sur le serveur FTP. Si une erreur se produit, renvoyez false .

Étapes pour obtenir une liste de fichiers à l'aide de ftp_nlist

1. Connectez-vous au serveur FTP

Tout d'abord, nous devons établir une connexion au serveur FTP. Utilisez la fonction FTP_Connect pour vous connecter au serveur FTP, puis utilisez FTP_LOGIN pour vous authentifier.

 <span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-variable">$ftp_server</span></span><span> = </span><span><span class="hljs-string">"ftp.example.com"</span></span><span>;
</span><span><span class="hljs-variable">$ftp_username</span></span><span> = </span><span><span class="hljs-string">"your_username"</span></span><span>;
</span><span><span class="hljs-variable">$ftp_password</span></span><span> = </span><span><span class="hljs-string">"your_password"</span></span><span>;

</span><span><span class="hljs-comment">// Se connecter àFTPserveur</span></span><span>
</span><span><span class="hljs-variable">$ftp_conn</span></span><span> = </span><span><span class="hljs-title function_ invoke__">ftp_connect</span></span><span>(</span><span><span class="hljs-variable">$ftp_server</span></span><span>) </span><span><span class="hljs-keyword">or</span></span><span> </span><span><span class="hljs-keyword">die</span></span><span>(</span><span><span class="hljs-string">"无法Se connecter àFTPserveur"</span></span><span>);

</span><span><span class="hljs-comment">// Se connecter</span></span><span>
</span><span><span class="hljs-variable">$login</span></span><span> = </span><span><span class="hljs-title function_ invoke__">ftp_login</span></span><span>(</span><span><span class="hljs-variable">$ftp_conn</span></span><span>, </span><span><span class="hljs-variable">$ftp_username</span></span><span>, </span><span><span class="hljs-variable">$ftp_password</span></span><span>);

</span><span><span class="hljs-keyword">if</span></span><span> (!</span><span><span class="hljs-variable">$login</span></span><span>) {
    </span><span><span class="hljs-keyword">die</span></span><span>(</span><span><span class="hljs-string">"Se connecter失败！"</span></span><span>);
}
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

2. Obtenez la liste des fichiers

Utilisez la fonction ftp_nlist pour obtenir la liste des fichiers et du répertoire du répertoire spécifié.

 <span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-variable">$directory</span></span><span> = </span><span><span class="hljs-string">"/path/to/directory"</span></span><span>; </span><span><span class="hljs-comment">// Répertoire des fichiers qui doivent être répertoriés</span></span><span>

</span><span><span class="hljs-comment">// Obtenez la liste des fichiers</span></span><span>
</span><span><span class="hljs-variable">$file_list</span></span><span> = </span><span><span class="hljs-title function_ invoke__">ftp_nlist</span></span><span>(</span><span><span class="hljs-variable">$ftp_conn</span></span><span>, </span><span><span class="hljs-variable">$directory</span></span><span>);

</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$file_list</span></span><span> === </span><span><span class="hljs-literal">false</span></span><span>) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"无法Obtenez la liste des fichiers"</span></span><span>;
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"Liste de fichiers：\n"</span></span><span>;
    </span><span><span class="hljs-keyword">foreach</span></span><span> (</span><span><span class="hljs-variable">$file_list</span></span><span> </span><span><span class="hljs-keyword">as</span></span><span> </span><span><span class="hljs-variable">$file</span></span><span>) {
        </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$file</span></span><span> . </span><span><span class="hljs-string">"\n"</span></span><span>;
    }
}
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

Dans le code ci-dessus, FTP_NList renverra un tableau, chaque élément du tableau est un fichier ou un nom de répertoire sous ce répertoire. Nous pouvons parcourir ce tableau avec ForEach et sortir le nom de chaque fichier ou répertoire.

3. Fermez la connexion FTP

Une fois l'opération terminée, n'oubliez pas de fermer la connexion FTP.

 <span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-comment">// fermetureFTPconnecter</span></span><span>
</span><span><span class="hljs-title function_ invoke__">ftp_close</span></span><span>(</span><span><span class="hljs-variable">$ftp_conn</span></span><span>);
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

Questions et précautions fréquemment posées

Problème de chemin : la liste des fichiers renvoyée par FTP_NList est relative au chemin spécifié. Si vous passez un chemin relatif, assurez-vous que le chemin que vous fournissez est correct. Si vous passez dans un chemin absolu, assurez-vous que la structure de fichiers du côté serveur correspond au chemin que vous fournissez.
Masquer les fichiers : sur certains serveurs FTP, les fichiers cachés (fichiers commençant par les points . ) Peut être répertorié. Vous pouvez obtenir plus d'informations sur les fichiers en utilisant FTP_RAWLIST , y compris les fichiers cachés.
Encodage de caractères : Si le nom de fichier du serveur FTP contient des caractères non ASCII (tels que chinois), vous devrez peut-être encoder et convertir le nom du fichier avant de l'afficher.

résumé

La fonction FTP_NList est un outil simple et efficace qui peut aider les développeurs à obtenir des listes de fichiers et répertoires sur le serveur FTP. En établissant une connexion, en appelant FTP_NList pour obtenir une liste de fichiers, en traversant et en sortissant des résultats, vous pouvez facilement gérer et utiliser des fichiers sur le serveur FTP.

Grâce à cet article, vous pouvez rapidement maîtriser comment utiliser cette fonction et l'appliquer de manière flexible à votre projet selon les besoins. J'espère que cet article vous aide!

Connexe