简单FTP部署

此软件包适用于Sublime Text ¾，允许您在本地文件保存或删除时自动上传或删除FTP服务器的文件，以及执行自定义触发器。

功能

• 在本地保存或删除文件时，上传或删除FTP服务器的文件
• TLS支持
• 高度可配置
• 如果服务器上不存在，将自动创建目录
• 在保存/删除时执行自定义触发器（请参阅此处示例使用 here）

如何安装

使用 Package Control

1. 在Sublime Text中打开菜单 工具 -> 命令面板...
2. 输入 Package Control: 安装软件包
3. 查找并安装 简单FTP部署

手册

1. 下载.zip
2. 打开 包 目录，您可以使用Sublime Text菜单项 首选项 -> 浏览包... 找到它
3. 将存档解压到该目录。

如何使用

1. 在Sublime Text中打开包含本地文件的文件夹 - 在菜单中打开 文件 -> 打开文件夹... 或 项目 -> 将文件夹添加到项目...。
2. 在打开文件夹的根目录中创建新的 simple-ftp-deploy.json 配置文件（其设置请参阅配置部分）
3. 保存配置文件。
4. 现在打开您要编辑的文件，它必须位于打开的目录中或在其内部文件夹中，如果您保存它，则此文件将被上传到配置文件中输入的FTP服务器。

配置

最简单的 simple-ftp-deploy.json 文件

{
    "host": "localhost",
    "username": "user",
    "password": "pass"
}

注意：密码是可选的。如果省略，则在需要时将提示您输入。

格式

格式为 JSON，因此每个属性都由键值对组成

{
    "host": "localhost",
    "port": 21,
    "username": "user",
    "password": "pass",
    "rootDirectory": "/path/",
    "ignoredFilenames": ["example.py", "anotherFilename.json"],
    "ignoredExtensions": [".ignore", ".txt"],
    "ignoredFolders": ["ignore", "IGNORE"],
    "reuseSessions": true,
    "connectionTimeout": 600,
    "passive": true,
    "useTLS": true,
    "disabledEvents": ["deleteFile"],
    "noPromptEvents": ["createFolder"],
    "triggers": [
        {
            "on": "save",
            "extensions": [".css", ".js"],
            "execute": ".simple-ftp-deploy/minifier.py"
        }
    ]
}

属性

"host" 字符串
您的FTP服务器的域名或IP地址。

"port" 端口号，可选（默认：21）
FTP服务器的端口号。

"username" 字符串
用户名。

"password" 字符串，可选
密码。如果没有给出，当需要时会要求输入。

"rootDirectory" 字符串，可选（默认："/"）
FTP部署路径。
示例：在FTP根目录下有三个文件夹 site1、site2 和 site3，如果你想上传到 site2 文件夹，必须将此属性设置为 /site2，因为如果省略此属性，文件将被上传到FTP的根目录。

"ignoredFilenames" 字符串数组，可选（默认：[]）
要忽略且不上传的文件名列表。注意，"simple-ftp-deploy.json" 总是被忽略。区分大小写

"ignoredExtensions" 字符串数组，可选（默认：[]）
要忽略的扩展名列表。注意，它只检查最后一个扩展名（因此 file.tar.gz 的扩展名为 ".gz"），如果你想忽略类似 .htaccess 的文件，该文件没有扩展名 => 使用 "ignoredFilenames" 代替。区分大小写

"ignoredFolders" 字符串数组，可选（默认：[]）
要忽略的文件夹名列表。如果文件位于指定的至少一个文件夹中，则忽略该文件（因此，如果 "ignoredFolders" 包含 "folder1" 和/或 "folder2"，则 folder1/folder2/file.py 被忽略）。区分大小写

"reuseSessions" 布尔值，可选（默认：true）
FTP会话将被重用进行后续操作（在 "connectionTimeout" 期间保持会话打开；之前称为 "sessionCacheEnabled"）。

"connectionTimeout" 数字，可选（默认：600）
设置FTP连接的超时时间（以秒为单位）。

"passive" 布尔值，可选（默认：true）
是否以被动模式连接到FTP服务器。

"useTLS" 布尔值，可选（默认：false）
是否以TLS连接连接到FTP服务器（在Sublime Text 3中可能无法正确工作）。

"disabledEvents" 字符串数组，可选（默认：[]）
要禁用的事件列表（例如如果不想每次被询问是否要从FTP服务器删除文件时都点击 取消）。可用事件："deleteFile"

"noPromptEvents" 字符串数组，可选（默认：[]）
不会提示您的事件列表（例如如果不想每次被询问是否要从FTP服务器删除文件时都点击 删除）。可用事件："deleteFile"、"createFolder"

"triggers" 触发器对象数组，可选（默认：[]）
在特定事件发生时调用的自定义触发器列表。每个触发器可以包含

• "on" 字符串 - 调用触发器的时间（可用值："save" 或 "delete"）。
• "extensions" 字符串数组，可选 - 对于哪些文件扩展调用此触发器。有关更多信息，请参阅 "ignoredExtension"。
• "filenames" 字符串数组，选项 - 对于哪些文件名调用此触发器。有关更多信息，请参阅 "ignoredFilenames"。
• "execute" 字符串 - 要执行的Python文件路径（自项目根目录相对路径）

有关触发器的示例用法，请参阅此处

贡献者

• Aiq0
• themiddlehalf

许可

MIT许可证