Check (and install if needed) required Visual C++ Redistributables when installing PHP

Author: mlocati

PhpManager/private/Constants.ps1

@@ -42,3 +42,5 @@ New-Variable -Option Constant -Scope Script -Name 'PEARSTATE_SNAPSHOT' -Value 's
 New-Variable -Option Constant -Scope Script -Name 'CACERT_PEM_URL' -Value 'https://curl.haxx.se/ca/cacert.pem'
 New-Variable -Option Constant -Scope Script -Name 'CACERT_CHECKSUM_URL' -Value 'https://curl.haxx.se/ca/cacert.pem.sha256'
 New-Variable -Option Constant -Scope Script -Name 'CACERT_CHECKSUM_ALGORITHM' -Value 'SHA256'
+
+New-Variable -Option Constant -Scope Script -Name 'STATUS_DLL_NOT_FOUND' -Value 0xC0000135

PhpManager/private/Install-PhpFromUrl.ps1

@@ -8,6 +8,12 @@ function Install-PhpFromUrl() {
 
     .Parameter Path
     The path where the archive should be extracted to.
+
+    .Parameter PhpVersion
+    The instance of PphVersion we are going to install.
+
+    .Parameter InstallVCRedist
+    Install the Visual C++ Redistributables if they are missing?
     #>
     Param(
         [Parameter(Mandatory = $True, Position = 0, HelpMessage = 'The URL where the binary archive can be downloaded from')]
@@ -17,17 +23,96 @@ function Install-PhpFromUrl() {
         [Parameter(Mandatory = $true, Position = 1, HelpMessage = 'The path where the archive should be extracted to')]
         [ValidateNotNull()]
         [ValidateLength(1, [int]::MaxValue)]
-        [string] $Path
+        [string] $Path,
+        [Parameter(Mandatory = $true, Position = 2, HelpMessage = 'The instance of PphVersion we are going to install')]
+        [ValidateNotNull()]
+        [psobject] $PhpVersion,
+        [Parameter(Mandatory = $true, Position = 3, HelpMessage = 'Install the Visual C++ Redistributables if they are missing?')]
+        [bool] $InstallVCRedist
     )
     Begin {
     }
     Process {
         $temporaryFile = Get-ZipFromUrl -Url $Url
         Try {
-            Write-Debug "Extracting $temporaryFile"
+            $temporaryDirectory = New-TempDirectory
+            Try {
+                Write-Debug "Extracting $temporaryFile to temporary directory"
+                Expand-Archive -LiteralPath $temporaryFile -DestinationPath $temporaryDirectory -Force
+                $exePath = Join-Path -Path $temporaryDirectory -ChildPath 'php.exe'
+                If (-Not(Test-Path -Path $exePath -PathType Leaf)) {
+                    Throw "Unable to find php.exe in the downloaded archive"
+                }
+                & $exePath @('-n', '-v') | Out-Null
+                If ($LASTEXITCODE -eq $Script:STATUS_DLL_NOT_FOUND) {
+                    Switch ($PhpVersion.VCVersion) {
+                        6 { $redistName = '6' } # PHP 5.2, PHP 5.3
+                        7 { $redistName = '2002' }
+                        7.1 { $redistName = '2003' }
+                        8 { $redistName = '2005' }
+                        9 { $redistName = '2008' } # PHP 5.4
+                        10 { $redistName = '2010' }
+                        11 { $redistName = '2012' } # PHP 5.5, PHP 5.6
+                        12 { $redistName = '2013' }
+                        14 { $redistName = '2015' } # PHP 7.0, PHP 7.1
+                        15 { $redistName = '2017' } # PHP 7.2
+                        default {
+                            Throw ('The Visual C++ ' + $PhpVersion.VCVersion + ' Redistributable seems to be missing: you have to install it manually (we can''t recognize its version)')
+                        }
+                    }
+                    If (-Not($InstallVCRedist)) {
+                        Throw "The Visual C++ $redistName Redistributable seems to be missing: you have to install it manually"
+                    }
+                    If (-Not(Get-Module -Name VcRedist)) {
+                        Throw "The Visual C++ $redistName Redistributable seems to be missing: you have to manually install it (if you install the VcRedist PowerShell module we could try to install it automatically)"
+                    }
+                    $vcListKind = 'Supported'
+                    $vcList = Get-VcList -Export $vcListKind | Where-Object { $_.Release -eq $redistName -and $_.Architecture -eq $PhpVersion.Architecture }
+                    If (-Not($vcList)) {
+                        $vcListKind = 'All'
+                        $vcList = Get-VcList -Export $vcListKind | Where-Object { $_.Release -eq $redistName -and $_.Architecture -eq $PhpVersion.Architecture }
+                        If (-Not($vcList)) {
+                            Throw "The Visual C++ $redistName Redistributable seems to be missing: you have to manually install it (the VcRedist PowerShell module doesn't support it)"
+                        }
+                    }
+                    Write-Output "Downloading the Visual C++ $redistName Redistributable (it's required by this version of PHP)"
+                    $temporaryDirectory2 = New-TempDirectory
+                    Try {
+                        $vcList | Get-VcRedist -Path $temporaryDirectory2
+                        Write-Output "Installing the Visual C++ $redistName Redistributable"
+                        $currentUser = [System.Security.Principal.WindowsPrincipal] [System.Security.Principal.WindowsIdentity]::GetCurrent()
+                        If ($currentUser.IsInRole([System.Security.Principal.WindowsBuiltInRole]::Administrator)) {
+                            $vcList | Install-VcRedist -Path $temporaryDirectory2
+                        } Else {
+                            $exeCommand = "Get-VcList -Export $vcListKind"
+                            $exeCommand += " | Where-Object { `$_.Release -eq '$redistName' -and `$_.Architecture -eq '" + $PhpVersion.Architecture + "'}"
+                            $exeCommand += " | Install-VcRedist -Path '" + ($temporaryDirectory2 -replace "'", "''") + "'"
+                            Start-Process -FilePath 'powershell.exe' -ArgumentList "-Command ""$exeCommand""" -Verb RunAs -Wait
+                        }
+                    } Finally {
+                        Try {
+                            Remove-Item -Path $temporaryDirectory2 -Recurse -Force
+                        } Catch {
+                            Write-Debug 'Failed to remove temporary folder'
+                        }
+                    }
+                }
+            }
+            Finally {
+                Try {
+                    Remove-Item -Path $temporaryDirectory -Recurse -Force
+                } Catch {
+                    Write-Debug 'Failed to remove temporary folder'
+                }
+            }
+            Write-Debug "Extracting $temporaryFile to destination directory"
             Expand-Archive -LiteralPath $temporaryFile -DestinationPath $Path -Force
         } Finally {
-            Remove-Item -Path $temporaryFile
+            Try {
+                Remove-Item -Path $temporaryFile
+            } Catch {
+                Write-Debug 'Failed to remove temporary file'
+            }
         }
     }
     End {

PhpManager/public/Install-Php.ps1

@@ -34,6 +34,9 @@ function Install-Php() {
     Specify if you want to add the PHP installation folder to the user ('User') or system ('System') PATH environment variable.
     Please remark that using 'System' usually requires administrative rights.
 
+    .Parameter InstallVC
+    Specify this switch to try to install automatically the required Visual C++ Redistributables (requires the VcRedist PowerShell package, and to run the process as an elevated user).
+
     .Parameter Force
     Use this switch to enable installing PHP even if the destination directory already exists and it's not empty.
     #>
@@ -54,6 +57,7 @@ function Install-Php() {
         [Parameter(Mandatory = $false, Position = 5, HelpMessage = 'Specify if you want to add the PHP installation folder to the user (''User'') or system (''System'') PATH environment variable')]
         [ValidateSet('User', 'System')]
         [string] $AddToPath,
+        [switch] $InstallVC,
         [switch] $Force
     )
     Begin {
@@ -122,7 +126,7 @@ function Install-Php() {
         }
         # Install the found PHP version
         Write-Output $('Installing PHP ' + $versionToInstall.DisplayName)
-        Install-PhpFromUrl -Url $versionToInstall.DownloadUrl -Path $Path
+        Install-PhpFromUrl -Url $versionToInstall.DownloadUrl -Path $Path -PhpVersion $versionToInstall -InstallVCRedist $InstallVC
         # Initialize the php.ini
         $IniPath = [System.IO.Path]::Combine($Path, 'php.ini');
         If (-Not(Test-Path -Path $IniPath -PathType Leaf)) {

PhpManager/public/Update-Php.ps1

@@ -84,7 +84,7 @@ function Update-Php() {
                 $updated = $false
             } else {
                 Write-Output $('Installing new version: ' + $bestNewVersion.DisplayName)
-                Install-PhpFromUrl -Url $bestNewVersion.DownloadUrl -Path ([System.IO.Path]::GetDirectoryName($installedVersion.ExecutablePath))
+                Install-PhpFromUrl -Url $bestNewVersion.DownloadUrl -Path ([System.IO.Path]::GetDirectoryName($installedVersion.ExecutablePath)) -PhpVersion $bestNewVersion -InstallVCRedist $false
                 $updated = $true
             }
         }