ndev-stack 0.1.0__py3-none-any.whl

ndev/linux/commands/reload.py

@@ -0,0 +1,26 @@
+import typer
+from ndev.common.constants import CURRENT_LINK
+from ndev.linux.runtime.fpm import reload_fpm
+from ndev.common.logger import logger
+
+def reload_cmd(target: str = typer.Argument(None, help="PHP version or service (e.g. 8.4, pma) to reload")):
+    """Gracefully reload PHP-FPM configuration for a version or restart pma service."""
+    if target and target.lower() in ["pma", "phpmyadmin"]:
+        from ndev.linux.runtime.pma import restart_pma
+        restart_pma()
+        return
+    from ndev.common.utils import get_version_or_prompt
+    try:
+        version = get_version_or_prompt(target, "PHP version or service to reload")
+        if version and version.lower() in ["pma", "phpmyadmin"]:
+            from ndev.linux.runtime.pma import restart_pma
+            restart_pma()
+            return
+        if not version:
+            logger.error("No version or service specified.")
+            raise typer.Exit(code=1)
+        reload_fpm(version)
+    except Exception as e:
+        logger.error(f"Failed to reload service: {e}")
+        raise typer.Exit(code=1)
+

ndev/linux/commands/restart.py

@@ -0,0 +1,34 @@
+import typer
+from ndev.common.constants import CURRENT_LINK
+from ndev.linux.runtime.fpm import restart_fpm
+from ndev.common.logger import logger
+
+def restart_cmd(target: str = typer.Argument(None, help="PHP version or service (e.g. 8.4, pma, mailpit) to restart")):
+    """Restart PHP-FPM for a version or a service like phpmyadmin (pma) or mailpit."""
+    if target and target.lower() in ["pma", "phpmyadmin"]:
+        from ndev.linux.runtime.pma import restart_pma
+        restart_pma()
+        return
+    if target and target.lower() in ["mailpit", "mail"]:
+        from ndev.linux.runtime.mailpit import restart_mailpit
+        restart_mailpit()
+        return
+    from ndev.common.utils import get_version_or_prompt
+    try:
+        version = get_version_or_prompt(target, "PHP version or service to restart")
+        if version and version.lower() in ["pma", "phpmyadmin"]:
+            from ndev.linux.runtime.pma import restart_pma
+            restart_pma()
+            return
+        if version and version.lower() in ["mailpit", "mail"]:
+            from ndev.linux.runtime.mailpit import restart_mailpit
+            restart_mailpit()
+            return
+        if not version:
+            logger.error("No version or service specified.")
+            raise typer.Exit(code=1)
+        restart_fpm(version)
+    except Exception as e:
+        logger.error(f"Failed to restart service: {e}")
+        raise typer.Exit(code=1)
+

ndev/linux/commands/setup.py

@@ -0,0 +1,113 @@
+import os
+import sys
+import shutil
+import subprocess
+import typer
+import httpx
+from pathlib import Path
+from rich.console import Console
+from ndev.common.constants import CURRENT_LINK
+from ndev.common.logger import logger
+
+console = Console()
+
+def chown_to_sudo_user(path: Path):
+    sudo_user = os.environ.get("SUDO_USER")
+    if sudo_user:
+        try:
+            import pwd
+            pw = pwd.getpwnam(sudo_user)
+            os.chown(str(path), pw.pw_uid, pw.pw_gid)
+        except Exception:
+            pass
+
+def get_user_local_bin_dir() -> Path:
+    sudo_user = os.environ.get("SUDO_USER")
+    if sudo_user:
+        try:
+            import pwd
+            return Path(pwd.getpwnam(sudo_user).pw_dir) / ".local" / "bin"
+        except Exception:
+            pass
+    return Path(os.path.expanduser("~/.local/bin"))
+
+def setup_cmd():
+    """Install MariaDB, Nginx, and Composer on the system (elevates with sudo for system packages)."""
+    if not shutil.which("apt-get"):
+        logger.error("This setup command is only supported on Debian-based systems with apt.")
+        raise typer.Exit(code=1)
+        
+    if not shutil.which("sudo"):
+        logger.error("sudo command not found. This command requires sudo to install system packages.")
+        raise typer.Exit(code=1)
+        
+    try:
+        # 1. Update Package Lists
+        console.print("[bold yellow]Updating package lists (sudo apt-get update)...[/bold yellow]")
+        subprocess.run(["sudo", "apt-get", "update"], check=True)
+        
+        # 2. Install MariaDB and Nginx
+        console.print("\n[bold yellow]Installing MariaDB and Nginx (sudo apt-get install)...[/bold yellow]")
+        subprocess.run(["sudo", "apt-get", "install", "-y", "mariadb-server", "nginx", "curl"], check=True)
+        console.print("[bold green]MariaDB and Nginx installed successfully![/bold green]\n")
+        
+        # 3. Install Composer
+        local_bin = get_user_local_bin_dir()
+        composer_bin = local_bin / "composer"
+        if composer_bin.exists():
+            console.print(f"[bold green]Composer is already installed at {composer_bin}[/bold green]")
+        else:
+            # Find PHP binary
+            php_bin = None
+            if CURRENT_LINK.exists() or CURRENT_LINK.is_symlink():
+                potential_php = CURRENT_LINK / "bin" / "php"
+                if potential_php.exists():
+                    php_bin = potential_php
+            if not php_bin:
+                system_php = shutil.which("php")
+                if system_php:
+                    php_bin = Path(system_php)
+                    
+            if not php_bin:
+                console.print("[bold yellow]PHP is not installed on the system (neither active ndev PHP nor system php).[/bold yellow]")
+                console.print("[bold yellow]Skipping Composer installation. Please install a PHP version first using 'ndev install <version>' and run setup again.[/bold yellow]")
+            else:
+                console.print("[bold yellow]Installing Composer...[/bold yellow]")
+                installer_url = "https://getcomposer.org/installer"
+                res = httpx.get(installer_url, follow_redirects=True)
+                if res.status_code != 200:
+                    raise RuntimeError(f"Failed to fetch Composer installer (HTTP status {res.status_code})")
+                    
+                setup_php = Path("/tmp/composer-setup.php")
+                setup_php.write_text(res.text)
+                
+                local_bin.mkdir(parents=True, exist_ok=True)
+                chown_to_sudo_user(local_bin)
+                
+                subprocess.run([str(php_bin), str(setup_php), f"--install-dir={local_bin}", "--filename=composer"], check=True)
+                if setup_php.exists():
+                    setup_php.unlink()
+                
+                chown_to_sudo_user(composer_bin)
+                console.print(f"[bold green]Composer installed successfully under {composer_bin}[/bold green]")
+                
+        # 4. Create ndev symlink in ~/.local/bin/ndev pointing to the virtualenv ndev executable
+        ndev_venv_path = Path(sys.executable).parent / "ndev"
+        if ndev_venv_path.exists():
+            ndev_link = local_bin / "ndev"
+            if ndev_link.exists() or ndev_link.is_symlink():
+                ndev_link.unlink()
+            local_bin.mkdir(parents=True, exist_ok=True)
+            chown_to_sudo_user(local_bin)
+            ndev_link.symlink_to(ndev_venv_path)
+            chown_to_sudo_user(ndev_link)
+            console.print(f"[bold green]Created symlink {ndev_link} -> {ndev_venv_path}[/bold green]")
+            
+        console.print("\n[bold green]System setup completed successfully![/bold green]")
+        
+    except subprocess.CalledProcessError as e:
+        logger.error(f"Command execution failed: {e}")
+        raise typer.Exit(code=1)
+    except Exception as e:
+        logger.error(f"Setup failed: {e}")
+        raise typer.Exit(code=1)

ndev/linux/commands/start.py

@@ -0,0 +1,34 @@
+import typer
+from ndev.common.constants import CURRENT_LINK
+from ndev.linux.runtime.fpm import start_fpm
+from ndev.common.logger import logger
+
+def start_cmd(target: str = typer.Argument(None, help="PHP version or service (e.g. 8.4, pma, mailpit) to start")):
+    """Start PHP-FPM for a version or a service like phpmyadmin (pma) or mailpit."""
+    if target and target.lower() in ["pma", "phpmyadmin"]:
+        from ndev.linux.runtime.pma import start_pma
+        start_pma()
+        return
+    if target and target.lower() in ["mailpit", "mail"]:
+        from ndev.linux.runtime.mailpit import start_mailpit
+        start_mailpit()
+        return
+    from ndev.common.utils import get_version_or_prompt
+    try:
+        version = get_version_or_prompt(target, "PHP version or service to start")
+        if version and version.lower() in ["pma", "phpmyadmin"]:
+            from ndev.linux.runtime.pma import start_pma
+            start_pma()
+            return
+        if version and version.lower() in ["mailpit", "mail"]:
+            from ndev.linux.runtime.mailpit import start_mailpit
+            start_mailpit()
+            return
+        if not version:
+            logger.error("No version or service specified.")
+            raise typer.Exit(code=1)
+        start_fpm(version)
+    except Exception as e:
+        logger.error(f"Failed to start service: {e}")
+        raise typer.Exit(code=1)
+

ndev/linux/commands/status.py

@@ -0,0 +1,81 @@
+import typer
+from rich.console import Console
+from rich.table import Table
+from ndev.common.constants import CURRENT_LINK
+from ndev.linux.runtime.fpm import get_fpm_status
+from ndev.common.logger import logger
+
+console = Console()
+
+def status_cmd(target: str = typer.Argument(None, help="PHP version or service (e.g. 8.4, pma, mailpit) to check status for")):
+    """Check status of a PHP-FPM version or service like pma or mailpit."""
+    if target and target.lower() in ["pma", "phpmyadmin"]:
+        from ndev.linux.runtime.pma import get_pma_status
+        status = get_pma_status()
+        table = Table(title="phpMyAdmin Service Status")
+        table.add_column("Property", style="bold cyan")
+        table.add_column("Value")
+        
+        status_text = "[bold green]Running[/bold green]" if status["running"] else "[bold red]Stopped[/bold red]"
+        table.add_row("Service", "phpMyAdmin (pma)")
+        table.add_row("Status", status_text)
+        table.add_row("PID", str(status["pid"]) if status["pid"] else "N/A")
+        table.add_row("Port", str(status["port"]) if status["port"] else "N/A")
+        table.add_row("URL", status["url"] if status["url"] else "N/A")
+        console.print(table)
+        return
+
+    if target and target.lower() in ["mailpit", "mail"]:
+        from ndev.linux.runtime.mailpit import get_mailpit_status
+        status = get_mailpit_status()
+        table = Table(title="Mailpit Service Status")
+        table.add_column("Property", style="bold cyan")
+        table.add_column("Value")
+
+        status_text = "[bold green]Running[/bold green]" if status["running"] else "[bold red]Stopped[/bold red]"
+        table.add_row("Service", "Mailpit")
+        table.add_row("Status", status_text)
+        table.add_row("PID", str(status["pid"]) if status["pid"] else "N/A")
+        table.add_row("SMTP Server", f"127.0.0.1:{status['smtp_port']}")
+        table.add_row("Web UI URL", status["url"] if status["url"] else f"http://127.0.0.1:{status['web_port']} (Stopped)")
+        console.print(table)
+        return
+
+    from ndev.common.utils import get_version_or_prompt
+    try:
+        version = get_version_or_prompt(target, "PHP version or service to check status")
+        if version and version.lower() in ["pma", "phpmyadmin"]:
+            from ndev.linux.runtime.pma import get_pma_status
+            status = get_pma_status()
+            table = Table(title="phpMyAdmin Service Status")
+            table.add_column("Property", style="bold cyan")
+            table.add_column("Value")
+            status_text = "[bold green]Running[/bold green]" if status["running"] else "[bold red]Stopped[/bold red]"
+            table.add_row("Service", "phpMyAdmin (pma)")
+            table.add_row("Status", status_text)
+            table.add_row("PID", str(status["pid"]) if status["pid"] else "N/A")
+            table.add_row("Port", str(status["port"]) if status["port"] else "N/A")
+            table.add_row("URL", status["url"] if status["url"] else "N/A")
+            console.print(table)
+            return
+
+        if not version:
+            logger.error("No version or service specified.")
+            raise typer.Exit(code=1)
+        status = get_fpm_status(version)
+        
+        table = Table(title=f"PHP-FPM {version} Status")
+        table.add_column("Property", style="bold cyan")
+        table.add_column("Value")
+        
+        status_text = "[bold green]Running[/bold green]" if status["running"] else "[bold red]Stopped[/bold red]"
+        table.add_row("Version", status["version"])
+        table.add_row("Status", status_text)
+        table.add_row("PID", str(status["pid"]) if status["pid"] else "N/A")
+        table.add_row("Socket Path", status["socket"])
+        table.add_row("Socket Active", "[green]Yes[/green]" if status["socket_exists"] else "[yellow]No[/yellow]")
+        
+        console.print(table)
+    except Exception as e:
+        logger.error(f"Failed to get service status: {e}")
+        raise typer.Exit(code=1)

ndev/linux/commands/stop.py

@@ -0,0 +1,34 @@
+import typer
+from ndev.common.constants import CURRENT_LINK
+from ndev.linux.runtime.fpm import stop_fpm
+from ndev.common.logger import logger
+
+def stop_cmd(target: str = typer.Argument(None, help="PHP version or service (e.g. 8.4, pma, mailpit) to stop")):
+    """Stop PHP-FPM for a version or a service like phpmyadmin (pma) or mailpit."""
+    if target and target.lower() in ["pma", "phpmyadmin"]:
+        from ndev.linux.runtime.pma import stop_pma
+        stop_pma()
+        return
+    if target and target.lower() in ["mailpit", "mail"]:
+        from ndev.linux.runtime.mailpit import stop_mailpit
+        stop_mailpit()
+        return
+    from ndev.common.utils import get_version_or_prompt
+    try:
+        version = get_version_or_prompt(target, "PHP version or service to stop")
+        if version and version.lower() in ["pma", "phpmyadmin"]:
+            from ndev.linux.runtime.pma import stop_pma
+            stop_pma()
+            return
+        if version and version.lower() in ["mailpit", "mail"]:
+            from ndev.linux.runtime.mailpit import stop_mailpit
+            stop_mailpit()
+            return
+        if not version:
+            logger.error("No version or service specified.")
+            raise typer.Exit(code=1)
+        stop_fpm(version)
+    except Exception as e:
+        logger.error(f"Failed to stop service: {e}")
+        raise typer.Exit(code=1)
+

ndev/linux/commands/uninstall.py

@@ -0,0 +1,69 @@
+import shutil
+import typer
+from ndev.common.constants import PHP_DIR, CURRENT_LINK
+from ndev.linux.runtime.fpm import stop_fpm
+from ndev.common.manifest import remove_installed_version
+from ndev.common.logger import logger
+
+def uninstall_cmd(version: str = typer.Argument(None, help="PHP version to uninstall (e.g. 8.4.23)")):
+    """Uninstall a compiled PHP version."""
+    if not version:
+        # Check if there are installed versions to list
+        installed_versions = []
+        if PHP_DIR.exists():
+            for path in PHP_DIR.iterdir():
+                if path.is_dir():
+                    installed_versions.append(path.name)
+        if installed_versions:
+            from packaging.version import parse as parse_version
+            try:
+                installed_versions = sorted(installed_versions, key=parse_version)
+            except Exception:
+                installed_versions = sorted(installed_versions)
+            from rich.console import Console
+            console = Console()
+            console.print("\n[bold]Installed PHP Versions[/bold]")
+            console.print("----------------------")
+            for i, v in enumerate(installed_versions):
+                console.print(f" {i + 1}) {v}")
+            console.print("")
+            try:
+                choice = typer.prompt("Select PHP version index or enter version directly", default="1")
+                try:
+                    idx = int(choice)
+                    if 1 <= idx <= len(installed_versions):
+                        version = installed_versions[idx - 1]
+                except ValueError:
+                    version = choice.strip()
+            except Exception:
+                pass
+        if not version:
+            version = typer.prompt("PHP version to uninstall").strip()
+            
+    if not version:
+        logger.error("PHP version is required.")
+        raise typer.Exit(code=1)
+        
+    prefix = PHP_DIR / version
+
+    if not prefix.exists():
+        logger.error(f"PHP version {version} is not installed.")
+        raise typer.Exit(code=1)
+        
+    try:
+        stop_fpm(version)
+        
+        logger.info(f"Removing files at {prefix}...")
+        shutil.rmtree(prefix)
+        
+        remove_installed_version(version)
+        
+        if CURRENT_LINK.exists() and CURRENT_LINK.is_symlink():
+            if CURRENT_LINK.resolve() == prefix.resolve():
+                logger.info("Removing symlink to current version.")
+                CURRENT_LINK.unlink()
+                
+        logger.info(f"PHP version {version} uninstalled successfully.")
+    except Exception as e:
+        logger.error(f"Uninstallation failed: {e}")
+        raise typer.Exit(code=1)

ndev/linux/commands/update.py

@@ -0,0 +1,57 @@
+import typer
+from packaging.version import parse as parse_version
+from rich.console import Console
+from rich.table import Table
+from ndev.common.constants import PHP_DIR
+from ndev.common.github import fetch_releases
+from ndev.common.logger import logger
+
+console = Console()
+
+def update_cmd():
+    """Check if installed PHP versions have newer patch releases available."""
+    if not PHP_DIR.exists():
+        logger.info("No PHP versions installed yet.")
+        return
+        
+    installed_versions = []
+    for path in PHP_DIR.iterdir():
+        if path.is_dir():
+            installed_versions.append(path.name)
+            
+    if not installed_versions:
+        logger.info("No PHP versions installed yet.")
+        return
+        
+    logger.info("Checking for newer patch releases...")
+    
+    table = Table(title="PHP Update Check")
+    table.add_column("Installed Version", style="bold cyan")
+    table.add_column("Latest Available")
+    table.add_column("Status")
+    
+    for v in installed_versions:
+        parts = v.split(".")
+        try:
+            major = int(parts[0])
+            minor_prefix = f"{parts[0]}.{parts[1]}."
+        except (ValueError, IndexError):
+            continue
+            
+        releases = fetch_releases(major)
+        if not releases:
+            table.add_row(v, "Unknown", "[yellow]Network Error[/yellow]")
+            continue
+            
+        matching = [rel for rel in releases.keys() if rel.startswith(minor_prefix)]
+        if not matching:
+            table.add_row(v, v, "Up to date")
+            continue
+            
+        latest = max(matching, key=parse_version)
+        if parse_version(latest) > parse_version(v):
+            table.add_row(v, latest, f"[bold yellow]Update Available[/bold yellow] (run 'ndev install {latest}')")
+        else:
+            table.add_row(v, v, "Up to date")
+            
+    console.print(table)

ndev/linux/commands/upgrade.py

@@ -0,0 +1,81 @@
+"""
+`ndev upgrade` command for Linux stack components.
+"""
+from __future__ import annotations
+
+from typing import Optional
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from ndev.linux.runtime import upgrade as upgrade_rt
+
+app = typer.Typer(help="Check for and upgrade stack components (Nginx, Mailpit, MariaDB, PMA, mkcert, Composer).")
+console = Console()
+
+
+@app.callback(invoke_without_command=True)
+def main(
+    ctx: typer.Context,
+    component: Optional[str] = typer.Argument(None, help="Component to upgrade (nginx, mailpit, mariadb, pma, mkcert, composer, or all)"),
+    check: bool = typer.Option(False, "--check", "-c", help="Only check for updates without applying upgrades."),
+):
+    if ctx.invoked_subcommand is not None:
+        return
+
+    console.print("\n[bold blue]ndev Linux Stack Component Updates & Upgrades[/bold blue]")
+
+    with console.status("[bold green]Checking component versions...[/bold green]"):
+        if component and component.lower() != "all":
+            infos = [info for info in upgrade_rt.check_all() if info.name == component.lower() or component.lower() in info.name]
+            if not infos:
+                console.print(f"[bold red]Unknown component '{component}'. Available: {', '.join(upgrade_rt.COMPONENTS)}[/bold red]")
+                raise typer.Exit(1)
+        else:
+            infos = upgrade_rt.check_all()
+
+    table = Table(title="Stack Components Version Status", show_header=True, header_style="bold cyan")
+    table.add_column("Component", style="bold", min_width=20)
+    table.add_column("Installed Version", min_width=18)
+    table.add_column("Latest Version", min_width=18)
+    table.add_column("Status", min_width=22)
+
+    upgradable = []
+    for info in infos:
+        curr_str = info.current_version or "[dim]Not installed[/dim]"
+        latest_str = info.latest_version or "[dim]Unknown[/dim]"
+        if not info.installed:
+            st_str = "[yellow]Not Installed[/yellow]"
+        elif info.update_available:
+            st_str = "[bold green]Update Available[/bold green]"
+            upgradable.append(info)
+        else:
+            st_str = "[green]Up-to-date[/green]"
+
+        table.add_row(info.display_name, curr_str, latest_str, st_str)
+
+    console.print(table)
+
+    if check:
+        if upgradable:
+            console.print(f"\n[bold green]{len(upgradable)} component(s) can be upgraded.[/bold green] Run `ndev upgrade` to apply.")
+        else:
+            console.print("\n[bold green]All installed components are up-to-date![/bold green]")
+        return
+
+    if not upgradable and not component:
+        console.print("\n[bold green]All installed components are up-to-date![/bold green]")
+        return
+
+    targets = [c.name for c in upgradable] if not component or component.lower() == "all" else [component.lower()]
+    console.print(f"\n[bold blue]Upgrading {len(targets)} component(s): {', '.join(targets)}...[/bold blue]\n")
+
+    for target in targets:
+        with console.status(f"[bold green]Upgrading {target}...[/bold green]"):
+            ok, msg = upgrade_rt.upgrade_component(target)
+        if ok:
+            console.print(f"[bold green]✓ {msg}[/bold green]")
+        else:
+            console.print(f"[bold red]✗ {msg}[/bold red]")
+
+    console.print("\n[bold green]Upgrade process complete![/bold green]")

ndev/linux/commands/use.py

@@ -0,0 +1,108 @@
+import typer
+import os
+import shutil
+from pathlib import Path
+from ndev.common.constants import PHP_DIR, CURRENT_LINK
+from ndev.common.logger import logger
+
+def use_cmd(version: str = typer.Argument(None, help="PHP version to use (must be installed)")):
+    """Set a PHP version as the active version."""
+    if not version:
+        # Check if there are installed versions to list
+        installed_versions = []
+        if PHP_DIR.exists():
+            for path in PHP_DIR.iterdir():
+                if path.is_dir():
+                    installed_versions.append(path.name)
+        if installed_versions:
+            from packaging.version import parse as parse_version
+            try:
+                installed_versions = sorted(installed_versions, key=parse_version)
+            except Exception:
+                installed_versions = sorted(installed_versions)
+            from rich.console import Console
+            console = Console()
+            console.print("\n[bold]Installed PHP Versions[/bold]")
+            console.print("----------------------")
+            for i, v in enumerate(installed_versions):
+                console.print(f" {i + 1}) {v}")
+            console.print("")
+            try:
+                choice = typer.prompt("Select PHP version index or enter version directly", default="1")
+                try:
+                    idx = int(choice)
+                    if 1 <= idx <= len(installed_versions):
+                        version = installed_versions[idx - 1]
+                except ValueError:
+                    version = choice.strip()
+            except Exception:
+                pass
+        if not version:
+            version = typer.prompt("PHP version to use").strip()
+            
+    if not version:
+        logger.error("PHP version is required.")
+        raise typer.Exit(code=1)
+        
+    target = PHP_DIR / version
+
+    if not target.exists():
+        logger.error(f"PHP version {version} is not installed. Install it first using 'ndev install {version}'.")
+        raise typer.Exit(code=1)
+        
+    try:
+        if CURRENT_LINK.exists() or CURRENT_LINK.is_symlink():
+            CURRENT_LINK.unlink()
+        CURRENT_LINK.symlink_to(target)
+        
+        # Ensure ~/.local/bin symlinks exist
+        local_bin = Path(os.path.expanduser("~/.local/bin"))
+        local_bin.mkdir(parents=True, exist_ok=True)
+        
+        links = {
+            "php": CURRENT_LINK / "bin" / "php",
+            "phpize": CURRENT_LINK / "bin" / "phpize",
+            "php-config": CURRENT_LINK / "bin" / "php-config",
+            "php-fpm": CURRENT_LINK / "sbin" / "php-fpm"
+        }
+        
+        for name, target_path in links.items():
+            link_path = local_bin / name
+            if link_path.exists() or link_path.is_symlink():
+                link_path.unlink()
+            link_path.symlink_to(target_path)
+            
+        logger.info(f"Now using PHP version {version}")
+        
+        # Check if ~/.local/bin is in PATH
+        path_env = os.environ.get("PATH", "")
+        local_bin_str = str(local_bin)
+        in_path = any(
+            p == local_bin_str or Path(p).resolve() == local_bin.resolve()
+            for p in path_env.split(os.pathsep)
+        )
+        if not in_path:
+            logger.warning(
+                f"[yellow]Warning: {local_bin} is not in your PATH. [/yellow]"
+                f"You may need to add it to your shell configuration (e.g. ~/.bashrc or ~/.zshrc):\n"
+                f'  export PATH="$HOME/.local/bin:$PATH"'
+            )
+        else:
+            # Verify if the active php command resolves to the ndev symlink
+            php_path = shutil.which("php")
+            if php_path:
+                try:
+                    resolved_php = Path(php_path).resolve()
+                    expected_php = (local_bin / "php").resolve()
+                    if resolved_php != expected_php:
+                        logger.warning(
+                            f"[yellow]Warning: The active PHP command resolves to '{resolved_php}' [/yellow]\n"
+                            f"which is not the ndev symlink '{expected_php}'.\n"
+                            f"Please ensure '{local_bin}' appears before other PHP installations in your PATH."
+                        )
+                except Exception:
+                    pass
+            
+    except Exception as e:
+        logger.error(f"Failed to switch PHP version: {e}")
+        raise typer.Exit(code=1)