public/Add-PhpToSwitcher.ps1
|
function Add-PhpToSwitcher { <# .Synopsis Adds a PHP installation to the PHP Switcher. .Parameter Name The symbolic name to give to the PHP installation. .Parameter Path The path to an existing PHP installation to be added to the PHP Switcher. .Parameter Force Force adding the PHP installation to the PHP Switcher even if another installation is already defined with the specified name. .Example Initialize-PhpSwitcher C:\PHP Add-PhpToSwitcher 5.6 C:\PHP5.6 Add-PhpToSwitcher 7.2 C:\PHP7.2 Switch-Php 5.6 #> [OutputType()] param ( [Parameter(Mandatory = $true, Position = 0, HelpMessage = 'The symbolic name to give to the PHP installation')] [ValidateNotNull()] [ValidateLength(1, [int]::MaxValue)] [string]$Name, [Parameter(Mandatory = $true, Position = 1, HelpMessage = 'The path to an existing PHP installation to be added to the PHP Switcher')] [ValidateNotNull()] [ValidateLength(1, [int]::MaxValue)] [string]$Path, [switch]$Force ) begin { } process { $switcher = Get-PhpSwitcher if ($null -eq $switcher) { throw 'PHP Switcher is not initialized: you can initialize it with the Initialize-PhpSwitcher command' } if ($switcher.Targets.ContainsKey($Name) -and -Not($Force)) { throw "Another PHP installation ($($switcher.Targets[$Name])) is already assigned to the PHP Switcher with the name $Name. Use the -Force flag to force the operation anyway." } $Path = [System.IO.Path]::GetFullPath($Path) if (-Not(Test-Path -LiteralPath $Path -PathType Container)) { throw "Unable to find the folder $Path" } $pathInfo = Get-Item -LiteralPath $Path if ($pathInfo.LinkType -eq 'Junction') { throw "$Path must be a regular directory (it is a junction)." } [PhpVersionInstalled]::FromPath($Path) | Out-Null $switcher.Targets[$Name] = $Path Set-PhpManagerConfigurationKey -Key 'PHP_SWITCHER' -Value $switcher -Scope $switcher.Scope } end { } } |