Skip to content
| Marketplace
Sign in
Visual Studio Code>Other>FTP-PHP Test DeployNew to Visual Studio Code? Get it now.
FTP-PHP Test Deploy

FTP-PHP Test Deploy

5001

|
2 installs
| (0) | Free
Universal tool to deploy build files via FTP/SFTP and execute SQL scripts on remote databases via PHP bridge or direct connection. Fully compatible with VS Code and Google Antigravity IDE.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

Universal FTP/SFTP/PHP Test Deploy

Universal FTP/SFTP/PHP Test Deploy is a specialized extension designed for both Visual Studio Code and Google Antigravity IDE. It modifies the standard local testing workflow by automatically deploying your project's build files to any remote server (via FTP or SFTP) and executing SQL scripts on remote databases before testing.

Instead of relying on a local development server (localhost), this plugin ensures you test your application directly in its real-world hosting environment, improving reliability and catching environment-specific bugs early. It's fully compatible with any hosting provider that supports FTP or SSH/SFTP and standard MySQL/MariaDB databases (e.g. Aruba, SiteGround, Hostinger, AWS, Serverplan, etc.).

New Features & Enhancements (v2.0.5)

  • Bidirectional Settings & Workspace Synchronization: Resolved configuration lockouts where workspace settings (.vscode/settings.json) forcibly overwrote global User settings with dummy placeholders (ftp.yourdomain.com). The extension now intelligently detects active User settings, automatically clears dummy templates, synchronizes changes reactively, and directs Open Settings straight to @ext:5001.ftp-php-test-deploy.
  • Local Path Visualization in Tree View: The 📁 Select Local Folder node in the Explorer sidebar is now an interactive expandable container. Expanding it reveals the active local build folder (e.g. dist (active), out (active), or . (project root)) with real-time status indicators, rich tooltips with full absolute filesystem paths, and click-to-change folder actions.
  • Native Root Deploy (/) & Path Normalization: Deploying directly to the server root (/) or custom remote directories without subfolders is now completely normalized. Trailing slashes and URI protocols are calculated centrally without double slashes (//), illegal root directory creations (mkdir('/')) are completely prevented, and remote browsing automatically coordinates remoteFolder with publicUrl.
  • Sync Cache Engine Hardening & SHA-1 Resilience: Eliminated false positives and false negatives where rebuild timestamps caused unneeded uploads or skipped modified files. File signatures (size, mtime, SHA-1 hash) are now registered directly from persistent source files before staging cleanup, and the cache engine provides automatic invalidation and clearing (clearSyncCache).

Previous Updates (v2.0.4)

  • Explorer Tree View Database Selector: Directly select the active remote database from the main Universal FTP Deploy tree view (🗄️ Database: <nome> or 🗄️ Seleziona Database Remoto) and trigger SQL workflows (⚡ Esegui SQL (Preflight / Migration / Postcheck)).
  • Remote Database Discovery & Listing: Queries the remote MySQL/MariaDB server (via secure PHP Bridge or Direct TCP Connection) to fetch available schemas (SHOW DATABASES or information_schema.SCHEMATA fallback). Presents an organized QuickPick separating user databases from system schemas (information_schema, sys, mysql), badge-highlighting the currently active database, and offering manual input fallback.
  • SQL Lifecycle Stages (Preflight, Migration, Postcheck):
    • Smart classification of SQL files based on naming patterns and folder organization into Preflight (preflight, init, schema), Migration (migration, update, alter), Postcheck (postcheck, verify, check), and General scripts.
    • Interactive workspace SQL picker grouping scripts cleanly by lifecycle stage with quick actions to switch target database or browse disk.
    • Detailed modal confirmation dialog prior to running any SQL file, explicitly confirming script name, detected lifecycle stage, target database, and DB host with options to run, switch database, or cancel.
  • Enhanced PHP Bridge & Direct Execution Engine:
    • Full support for SELECT queries (crucial in preflight schema checks and postcheck verification) without PDO exceptions, returning execution summaries and row counts.
    • Support for custom MySQL ports with host:port splitting in both PDO DSN and direct connection methods.
    • Structured stage headers and execution times in the dedicated Database & Preflight OutputChannel.
  • Sanitized Configurations: Completely sanitized all default settings and templates of personal domains, accounts, and credentials.

Previous Updates (v2.0.3)

  • Smart Sync Caching & SHA-1 Content Hash: Fixed the perpetual re-upload issue where running a project build (e.g. npm run build) caused all files to be flagged as modified and re-uploaded due to timestamp resets. The extension now caches file signatures (size, mtime, and SHA-1 hash) in .vscode/.ftp-deploy-sync.json. Even if timestamps change after a fresh rebuild, unchanged files with matching SHA-1 hashes are skipped automatically.
  • Visual Upload Progress Bar: Added a real-time determinate progress bar with live percentage indicators, file counts (current/total), unicode visual bars ([██████░░░░░░]), and descriptive status symbols (⬆️ Upload, ❌ Delete) in both the status notification and the output channel.
  • Detailed Sync Status Modal Dialog: The "Verify Sync Status" command now presents a comprehensive modal summary dialog breaking down:
    • ✨ New files to upload (with count and file preview, even if 0).
    • ✏️ Modified files to update (with count and file preview, even if 0).
    • 🗑️ Orphan remote files to delete (with count and file preview, even if 0).
    • ⚙️ Remote Deletion Status (deleteRemoteFiles): Explicitly indicates whether automatic remote file deletion is ATTIVATA (orphan files will be removed on next deploy) or DISATTIVATA (orphan files will be preserved on the server).
    • Direct Actions: Interactive buttons to trigger deployment immediately (🚀 Avvia Deploy) or inspect the complete detailed list in the output panel (📋 Mostra nell'Output).
  • Tree View Remote Deletion State: When ftpDeploy.deleteRemoteFiles is disabled, remote orphan files in the Explorer Tree View are explicitly marked with (eliminazione disattivata).
  • Lean Extension Package: Excluded unnecessary webview build artifacts and wasm modules from the package to keep extension size minimal and fast to install.

Previous Updates (v2.0 - Universal PHP Deploy)

  • PHP Database Bridge: Safely execute SQL scripts directly on remote MySQL/MariaDB databases (even on shared hosts that block remote connections) by automatically deploying and executing a temporary, secure PHP bridge script.
  • Run SQL Files Remotely: Right-click any .sql file in the Explorer and select Universal FTP/PHP: Execute SQL via PHP Bridge to apply database changes instantly.
  • Dedicated PHP Deploy View: A brand new "Universal PHP Deploy" view in the sidebar to configure database credentials, toggle the PHP bridge, and instantly test the database connection.
  • Automatic Cleanup: The temporary PHP bridge securely deletes itself immediately after execution to guarantee maximum security.

Previous Updates (v1.3.20)

  • Remote File Deletion: Added a new setting ftpDeploy.deleteRemoteFiles that allows the extension to automatically delete files on the remote server that no longer exist in your local project folder during synchronization.
  • Enhanced Sync Status & Dialogs: The "Verify Sync Status" feature and upload dialogs now display the exact number of new, modified, and to-be-deleted files. Deleted files are also visually flagged with an ❌ icon in the Tree View.
  • Accurate Staging Timestamps: Fixed a bug where deploying with excluded files would trigger a full re-upload of all files by accurately preserving local modification times during the staging phase.

Previous Updates (v1.3.18)

  • Settings Layout & Order: Restructured the Settings UI to preserve logical categories (Server Connection, Remote Paths, etc.) and ensure the proper display order. The Status Bar 'FTP Settings' button now correctly bypasses global search to maintain this strict categorization.
  • Settings Export/Import: You can now export your FTP settings to a JSON file and import them into another project, making it easier to share configurations. Dedicated import and export icons have been added for these commands.
  • Status Bar Settings Button: Added a convenient "FTP Settings" button in the status bar for quick access to the extension's configuration.
  • Improved UI for Long URLs: The Remote Target and Preview URL in the side panel are now displayed clearly even when the paths are very long. Additionally, hovering over them with your mouse will reveal the full, untruncated URL in a tooltip.
  • Default Language: The default language has been updated to English for broader compatibility.

Previous Updates (v1.3.10)

  • Visual Folder Selection: You can now use the "📁 Select Local Folder" and "☁️ Select Remote FTP Folder" buttons directly from the side panel to configure paths without typing text. The remote FTP browser allows you to navigate live through the server's folders!
  • Verify Sync Status: Click "🔄 Verify Sync Status" in the side panel to compare the local folder with the remote one. The extension will display a dot (●) next to the files that need to be uploaded (because they are new or modified) and an (❌) next to deleted files.
  • Incremental Synchronization: During deployment, only the newly created or modified files will be uploaded, and removed files can be automatically deleted on the server.
  • Multilingual Support & UI Improvements: Added support for both English and Italian languages, adjustable via settings. Settings have been logically grouped for a better user experience.

Features

Core

  • Automated FTP/SFTP Deployment: Automatically syncs your build folder (e.g., out or dist) to a remote server.
  • Static Site Support: If no build folder is detected, the plugin uploads the project root directly, intelligently filtering out system files (.git, node_modules, .vscode, etc.).
  • IDE & Agent Integration: Integrates seamlessly with Visual Studio Code and Google Antigravity IDE (and its AI agents), overriding default behaviors to prevent local testing and enforce remote validation when active.

Database & SQL (Preflight / Migration / Postcheck)

  • Interactive Database Selection: Select target databases on the remote host directly from the Tree View menu with live discovery of remote databases.
  • Preflight, Migration & Postcheck Workflows: Categorizes scripts automatically into Preflight (schema & prerequisite checks), Migration (table alterations, data migrations), and Postcheck (data verification & integrity validation).
  • Execution Confirmation Dialog: Transparently presents execution stage, script name, target database, and host before executing queries to prevent accidental operations.
  • Dual Connection Engine: Supports both the temporary, self-cleaning PHP Bridge (via HTTP/HTTPS, ideal for Aruba and shared hostings that block external MySQL port 3306) and Direct Connection (direct TCP connection for VPS, dedicated servers, or providers like Libero).
  • SELECT & Inspection Support: Fully executes read queries and verification scripts without throwing PDO errors, showing affected rows and query result summaries.
  • Security & Immediate Cleanup: Temporary PHP bridge scripts and database tokens are erased from the remote server immediately after query execution.

User Interface

  • One-Click Upload (☁️ Upload FTP): A prominent button in the VS Code StatusBar and an icon in the Explorer panel let you deploy your project with a single click.
  • Test Connection: A Test FTP button in the StatusBar lets you instantly verify your credentials and network connection.
  • Preview URL: The Explorer panel shows your public test URL. Click it to open the deployed site directly in your browser.
  • Progress & Notifications: During upload, a native VS Code progress bar appears. On success, a popup offers a one-click "Open Preview" button to open the site.
  • Output Channel: A dedicated "Universal FTP/PHP Deploy" output panel shows real-time logs of every connection, upload, and error.

Sync Indicators

  • File Modification Tracking (●): Files modified since the last upload are marked with a ● dot and the label "not synced".
  • Recursive Folder Tracking: If a folder contains any modified file (even nested), the folder itself shows the ● dot with "contains files to sync".
  • Remote Deletion Tracking (❌): Files deleted locally but still present on the server are marked with an ❌ icon in the Tree View and can be automatically deleted remotely.
  • Automatic Reset: After a successful upload, all sync indicators disappear instantly, confirming your project is fully synchronized.
  • Real-Time Updates: A built-in FileSystemWatcher detects file changes in real time, updating the indicators immediately when you save.

File Exclusion

  • Exclude from Upload: Right-click any file or folder in the Explorer panel → "Exclude from Upload" to prevent it from being uploaded.
  • Include Again: Right-click an excluded item → "Include in Upload" to restore it.
  • Multi-Selection: Select multiple items with Cmd+Click (Mac) or Ctrl+Click (Windows) and apply exclude/include to all at once.
  • Visual Indicator: Excluded items show ⛔ excluded from upload and are skipped during deployment.
  • Persistent: The exclusion list is saved per-project in .vscode/settings.json.

Configuration

  • Easy Configuration: A built-in Settings UI to manage your host, port, credentials, and paths.
  • Auto-Detect Build Folder: Smartly detects common build folders (out, dist, build, public).
  • Create Remote Folder: Optionally auto-creates the destination folder on your FTP server if it doesn't exist.
  • Project Auto-Isolation: Every time you open a project, the plugin automatically isolates its FTP settings into a local .vscode/settings.json file. This prevents projects from overwriting each other's remote folders. (Warning: Ensure your .vscode folder is in .gitignore to avoid exposing FTP credentials to public repositories).

AI Integration Prompts

You can train your favorite AI coding assistants to automatically use this extension for testing your project instead of running a local server. Copy and paste the prompts below into your AI's custom instructions, rules file, or system prompt.

Google Antigravity IDE

Add this to your workspace rules (e.g. .agents/AGENTS.md):

# Rule: Mandatory Remote Testing Workflow
When testing or verifying changes:
1. DO NOT start a local development server (like `localhost` or `npm run dev`).
2. Ask the user: "Which local folder should I build and deploy? (e.g., dist, out, build, public)". Wait for their response.
3. Build the project to the specified folder.
4. Trigger the deploy command (or use the deploy skill available in the workspace) to upload the build to the remote server.
5. Use the provided public URL to test the live application.

Codex / Cursor / GitHub Copilot

Add this to your .cursorrules or Copilot custom instructions:

# Remote Testing Protocol
Always test web applications remotely. Never use localhost or npm run dev.
Before testing:
1. Ask me: "Which local folder contains the build output to deploy? (e.g., dist, out)"
2. Run the build script to generate the files in that folder.
3. Trigger the "Universal FTP: Deploy Project" command in VS Code (`ftpDeploy.runDeploy`).
4. Verify the deployment on the remote server URL.

Claude Code

Add this to your Claude project instructions or provide it directly in the chat:

When I ask you to test the app, follow this remote testing protocol:
- Do not run local servers (no localhost).
- Ask me: "What is the local build folder to use for deployment?" and wait for my answer.
- Build the project.
- Use the VS Code extension "Universal FTP/SFTP/PHP Test Deploy" (command `ftpDeploy.runDeploy`) to deploy the files to the remote server.
- Test the application using the public remote URL.

Usage & License

This plugin is freely installable and free to use. You are welcome to download, install, and utilize this tool in your personal or commercial projects without any charges.

Credits & Copyright

  • Author: 5001.tech
  • Copyright: © 2026 5001.tech. All rights reserved.

Developed with ❤️ to improve testing workflows.

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft