1. 程式人生 > 其它 >vscode安裝composeer Visual Studio Code 開發PHP專案和Composer的配置

vscode安裝composeer Visual Studio Code 開發PHP專案和Composer的配置

Visual Studio Code 開發PHP專案和Composer的配置

 

Visual Studio Code(vscode)已經成為了一個成熟的跨平臺跨語言開發IDE,PHP開發者也可以嘗試使用vscode管理和開發自己的專案。

PHP開發者使用VSCODE可以使用的最簡單擴充套件配置如下:

1. composer,沒有composer的IDE開發PHP是沒有靈魂的,注意安裝Composer的時候請勾選開發模式,否則VSCODE無法執行命令等,安裝之後注意在setting.json中配置以下節點:

{
    "composer.executablePath":"c:\\composer\\composer.bat",
    "composer.workingPath": "D:\\centos\\myprograms",
}

2. php的程式碼格式化和自適應外掛phpfmt - PHP formatter ,PHP IntelliSense ,在這兩個外掛的配合下,PHP開發者體驗會同時擁有Zend Studio和Sublime的良好體驗,當然也是需要配置PHP可執行路徑的,否則沒有相關API的支援安裝了也是白搭。

{
    "php.validate.executablePath": "D:\\phpstudy_pro\\Extensions\\php\\php7.3.4nts_p\\php.exe",
    "phpfmt.php_bin": "D:\\phpstudy_pro\\Extensions\\php\\php7.3.4nts_p\\php.exe",
    "php.executablePath": "D:\\phpstudy_pro\\Extensions\\php\\php7.3.4nts_p\\php.exe", 
}

板磚實踐認為,以上3個重要外掛即可滿足PHP的日常主要開發了,當然專案中需要引用的擴充套件還需要開發者自行補充。

在composer的使用中大家可能會遇到的幾個問題有:

1. 映象問題,當然composer的中文映象有些時候是有作用的,但是不穩定,所以推薦使用阿里雲映象,可以解決例如“Expected one of: 'STRING', 'NUMBER', 'NULL', 'TRUE', 'FALSE', '{', '['”這類問題

	"repositories": {
		"packagist": {
			"type": "composer",
			"url": "https://mirrors.aliyun.com/composer/"
		}
	},

2. composer.phar檔案不存在的問題,一般來說你需要檢查問題目錄,刪除composer.bat檔案,使用安裝預設位置的檔案。

Composer 的安裝

Wondows 平臺

Wondows 平臺上,我們只需要下載 Composer-Setup.exe 後,一步步安裝即可。

需要注意的是你需要開啟 openssl 配置,我們開啟 php 目錄下的 php.ini,將 extension=php_openssl.dll 前面的分號去掉就可以了。

安裝成功後,我們可以通過命令視窗(cmd) 輸入 composer --version 命令來檢視是否安裝成功:

接下來我們可以更改阿里雲 Composer 全量映象:

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

取消配置:

composer config -g --unset repos.packagist

專案配置

僅修改當前工程配置,僅當前工程可使用該映象地址:

composer config repo.packagist composer https://mirrors.aliyun.com/composer/

取消配置:

composer config --unset repos.packagist

除錯

composer 命令增加 -vvv 可輸出詳細的資訊,命令如下:

composer -vvv require alibabacloud/sdk

遇到問題?

1. 建議先將Composer版本升級到最新:

composer self-update

2. 執行診斷命令:

composer diagnose

3. 清除快取:

composer clear

4. 若專案之前已通過其他源安裝,則需要更新 composer.lock 檔案,執行命令:

composer update --lock

5. 重試一次

Linux 平臺

Linux 平臺可以使用以下命令來安裝:

# php -r "copy('https://install.phpcomposer.com/installer', 'composer-setup.php');"
# php composer-setup.php

All settings correct for using Composer
Downloading...

Composer (version 1.6.5) successfully installed to: /root/composer.phar
Use it: php composer.phar

移動 composer.phar,這樣 composer 就可以進行全域性呼叫:

# mv composer.phar /usr/local/bin/composer

切換為國內映象:

# composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

更新 composer:

# composer selfupdate

Mac OS 系統

Mac OS 系統可以使用以下命令來安裝:

$ curl -sS https://getcomposer.org/installer | php
$ sudo mv composer.phar /usr/local/bin/composer
$ composer --version
Composer version 1.7.2 2018-08-16 16:57:12

切換為國內映象:

$ composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

更新 composer:

$ composer selfupdate

Composer 的使用

要使用 Composer,我們需要先在專案的目錄下建立一個 composer.json 檔案,檔案描述了專案的依賴關係。

檔案格式如下:

{
    "require": {
        "monolog/monolog": "1.2.*"
    }
}

以上檔案說明我們需要下載從 1.2 開始的任何版本的 monolog。

接下來只要執行以下命令即可安裝依賴包:

composer install

require 命令

除了使用 install 命令外,我們也可以使用 require 命令快速的安裝一個依賴而不需要手動在 composer.json 裡新增依賴資訊:

$ composer require monolog/monolog

Composer 會先找到合適的版本,然後更新composer.json檔案,在 require 那新增 monolog/monolog 包的相關資訊,再把相關的依賴下載下來進行安裝,最後更新 composer.lock 檔案並生成 php 的自動載入檔案。

update 命令

update 命令用於更新專案裡所有的包,或者指定的某些包:

# 更新所有依賴
$ composer update

# 更新指定的包
$ composer update monolog/monolog

# 更新指定的多個包
$ composer update monolog/monolog symfony/dependency-injection

# 還可以通過萬用字元匹配包
$ composer update monolog/monolog symfony/*

需要注意的時,包能升級的版本會受到版本約束的約束,包不會升級到超出約束的版本的範圍。例如如果 composer.json 裡包的版本約束為 ^1.10,而最新版本為 2.0。那麼 update 命令是不能把包升級到 2.0 版本的,只能最高升級到 1.x 版本。關於版本約束請看後面的介紹。

remove 命令

remove 命令用於移除一個包及其依賴(在依賴沒有被其他包使用的情況下),如果依賴被其他包使用,則無法移除:

$ composer remove monolog/monolog
Loading composer repositories with package information
Updating dependencies (including require-dev)
Package operations: 0 installs, 0 updates, 2 removals
  - Removing psr/log (1.0.2)
  - Removing monolog/monolog (1.23.0)
Generating autoload files

search 命令

search 命令可以搜尋包:

$ composer search monolog

該命令會輸出包及其描述資訊,如果只想輸出包名可以使用 --only-name 引數:

$ composer search --only-name monolog

show 命令

show 命令可以列出當前專案使用到包的資訊:

# 列出所有已經安裝的包
$ composer show

# 可以通過萬用字元進行篩選
$ composer show monolog/*

# 顯示具體某個包的資訊
$ composer show monolog/monolog

基本約束

精確版本

我們可以告訴 Composer 安裝的具體版本,例如:1.0.2,指定 1.0.2 版本。

範圍

通過使用比較操作符來指定包的範圍。這些操作符包括:>,>=,<,<=,!=。

你可以定義多個範圍,使用空格或者逗號 , 表示邏輯上的與,使用雙豎線 || 表示邏輯上的或。其中與的優先順序會大於或。 例項:

  • >=1.0
  • >=1.0 <2.0
  • >=1.0 <1.1 || >=1.2

我們也可以通過使用連字元 - 來指定版本範圍。

連字元的左邊表明了 >= 的版本,如果右邊的版本不是完整的版本號,則會被使用萬用字元進行補全。例如1.0 - 2.0等同於>=1.0.0 <2.12.0相當於2.0.*),而1.0.0 - 2.1.0則等同於>=1.0.0 <=2.1.0

萬用字元

可以使用萬用字元來設定版本。1.0.*相當於>=1.0 <1.1
例子:1.0.*

波浪號 ~

我們先通過後面這個例子去解釋~操作符的用法:~1.2相當於>=1.2 <2.0.0,而~1.2.3相當於>=1.2.3 <1.3.0。對於使用Semantic Versioning作為版本號標準的專案來說,這種版本約束方式很實用。例如~1.2定義了最小的小版本號,然後你可以升級2.0以下的任何版本而不會出問題,因為按照Semantic Versioning的版本定義,小版本的升級不應該有相容性的問題。簡單來說,~定義了最小的版本,並且允許版本的最後一位版本號進行升級(沒懂得話,請再看一邊前面的例子)。
例子:~1.2

需要注意的是,如果~作用在主版本號上,例如~1,按照上面的說法,Composer可以安裝版本1以後的主版本,但是事實上是~1會被當作~1.0對待,只能增加小版本,不能增加主版本。

折音號 ^

^操作符的行為跟Semantic Versioning有比較大的關聯,它允許升級版本到安全的版本。例如,^1.2.3相當於>=1.2.3 <2.0.0,因為在2.0版本前的版本應該都沒有相容性的問題。而對於1.0之前的版本,這種約束方式也考慮到了安全問題,例如^0.3會被當作>=0.3.0 <0.4.0對待。
例子:^1.2.3


版本穩定性

如果你沒有顯式的指定版本的穩定性,Composer會根據使用的操作符,預設在內部指定為-dev或者-stable。例如:

約束 內部約束
1.2.3 =1.2.3.0-stable
>1.2 >1.2.0.0-stable
>=1.2 >=1.2.0.0-dev
>=1.2-stable >=1.2.0.0-stable
<1.3 <1.3.0.0-dev
<=1.3 <=1.3.0.0-stable
1 - 2 >=1.0.0.0-dev <3.0.0.0-dev
~1.3 >=1.3.0.0-dev <2.0.0.0-dev
1.4.* >=1.4.0.0-dev <1.5.0.0-dev

例子:1.0 - 2.0

如果你想指定版本只要穩定版本,你可以在版本後面新增字尾-stable

minimum-stability 配置項定義了包在選擇版本時對穩定性的選擇的預設行為。預設是stable。它的值如下(按照穩定性排序):devalphabetaRCstable。除了修改這個配置去修改這個預設行為,我們還可以通過穩定性標識(例如@stable@dev)來安裝一個相比於預設配置不同穩定性的版本。例如:

{
    "require": {
        "monolog/monolog": "1.0.*@beta",
        "acme/foo": "@dev"
    }
}

Visual Studio Code(vscode)已經成為了一個成熟的跨平臺跨語言開發IDE,PHP開發者也可以嘗試使用vscode管理和開發自己的專案。

PHP開發者使用VSCODE可以使用的最簡單擴充套件配置如下:

1. composer,沒有composer的IDE開發PHP是沒有靈魂的,注意安裝Composer的時候請勾選開發模式,否則VSCODE無法執行命令等,安裝之後注意在setting.json中配置以下節點:

{
    "composer.executablePath":"c:\\composer\\composer.bat",
    "composer.workingPath": "D:\\centos\\myprograms",
}

2. php的程式碼格式化和自適應外掛phpfmt - PHP formatter ,PHP IntelliSense ,在這兩個外掛的配合下,PHP開發者體驗會同時擁有Zend Studio和Sublime的良好體驗,當然也是需要配置PHP可執行路徑的,否則沒有相關API的支援安裝了也是白搭。

{
    "php.validate.executablePath": "D:\\phpstudy_pro\\Extensions\\php\\php7.3.4nts_p\\php.exe",
    "phpfmt.php_bin": "D:\\phpstudy_pro\\Extensions\\php\\php7.3.4nts_p\\php.exe",
    "php.executablePath": "D:\\phpstudy_pro\\Extensions\\php\\php7.3.4nts_p\\php.exe", 
}

板磚實踐認為,以上3個重要外掛即可滿足PHP的日常主要開發了,當然專案中需要引用的擴充套件還需要開發者自行補充。

在composer的使用中大家可能會遇到的幾個問題有:

1. 映象問題,當然composer的中文映象有些時候是有作用的,但是不穩定,所以推薦使用阿里雲映象,可以解決例如“Expected one of: 'STRING', 'NUMBER', 'NULL', 'TRUE', 'FALSE', '{', '['”這類問題

	"repositories": {
		"packagist": {
			"type": "composer",
			"url": "https://mirrors.aliyun.com/composer/"
		}
	},

2. composer.phar檔案不存在的問題,一般來說你需要檢查問題目錄,刪除composer.bat檔案,使用安裝預設位置的檔案。

Composer 的安裝

Wondows 平臺

Wondows 平臺上,我們只需要下載 Composer-Setup.exe 後,一步步安裝即可。

需要注意的是你需要開啟 openssl 配置,我們開啟 php 目錄下的 php.ini,將 extension=php_openssl.dll 前面的分號去掉就可以了。

安裝成功後,我們可以通過命令視窗(cmd) 輸入 composer --version 命令來檢視是否安裝成功:

接下來我們可以更改阿里雲 Composer 全量映象:

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

取消配置:

composer config -g --unset repos.packagist

專案配置

僅修改當前工程配置,僅當前工程可使用該映象地址:

composer config repo.packagist composer https://mirrors.aliyun.com/composer/

取消配置:

composer config --unset repos.packagist

除錯

composer 命令增加 -vvv 可輸出詳細的資訊,命令如下:

composer -vvv require alibabacloud/sdk

遇到問題?

1. 建議先將Composer版本升級到最新:

composer self-update

2. 執行診斷命令:

composer diagnose

3. 清除快取:

composer clear

4. 若專案之前已通過其他源安裝,則需要更新 composer.lock 檔案,執行命令:

composer update --lock

5. 重試一次

Linux 平臺

Linux 平臺可以使用以下命令來安裝:

# php -r "copy('https://install.phpcomposer.com/installer', 'composer-setup.php');"
# php composer-setup.php

All settings correct for using Composer
Downloading...

Composer (version 1.6.5) successfully installed to: /root/composer.phar
Use it: php composer.phar

移動 composer.phar,這樣 composer 就可以進行全域性呼叫:

# mv composer.phar /usr/local/bin/composer

切換為國內映象:

# composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

更新 composer:

# composer selfupdate

Mac OS 系統

Mac OS 系統可以使用以下命令來安裝:

$ curl -sS https://getcomposer.org/installer | php
$ sudo mv composer.phar /usr/local/bin/composer
$ composer --version
Composer version 1.7.2 2018-08-16 16:57:12

切換為國內映象:

$ composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

更新 composer:

$ composer selfupdate

Composer 的使用

要使用 Composer,我們需要先在專案的目錄下建立一個 composer.json 檔案,檔案描述了專案的依賴關係。

檔案格式如下:

{
    "require": {
        "monolog/monolog": "1.2.*"
    }
}

以上檔案說明我們需要下載從 1.2 開始的任何版本的 monolog。

接下來只要執行以下命令即可安裝依賴包:

composer install

require 命令

除了使用 install 命令外,我們也可以使用 require 命令快速的安裝一個依賴而不需要手動在 composer.json 裡新增依賴資訊:

$ composer require monolog/monolog

Composer 會先找到合適的版本,然後更新composer.json檔案,在 require 那新增 monolog/monolog 包的相關資訊,再把相關的依賴下載下來進行安裝,最後更新 composer.lock 檔案並生成 php 的自動載入檔案。

update 命令

update 命令用於更新專案裡所有的包,或者指定的某些包:

# 更新所有依賴
$ composer update

# 更新指定的包
$ composer update monolog/monolog

# 更新指定的多個包
$ composer update monolog/monolog symfony/dependency-injection

# 還可以通過萬用字元匹配包
$ composer update monolog/monolog symfony/*

需要注意的時,包能升級的版本會受到版本約束的約束,包不會升級到超出約束的版本的範圍。例如如果 composer.json 裡包的版本約束為 ^1.10,而最新版本為 2.0。那麼 update 命令是不能把包升級到 2.0 版本的,只能最高升級到 1.x 版本。關於版本約束請看後面的介紹。

remove 命令

remove 命令用於移除一個包及其依賴(在依賴沒有被其他包使用的情況下),如果依賴被其他包使用,則無法移除:

$ composer remove monolog/monolog
Loading composer repositories with package information
Updating dependencies (including require-dev)
Package operations: 0 installs, 0 updates, 2 removals
  - Removing psr/log (1.0.2)
  - Removing monolog/monolog (1.23.0)
Generating autoload files

search 命令

search 命令可以搜尋包:

$ composer search monolog

該命令會輸出包及其描述資訊,如果只想輸出包名可以使用 --only-name 引數:

$ composer search --only-name monolog

show 命令

show 命令可以列出當前專案使用到包的資訊:

# 列出所有已經安裝的包
$ composer show

# 可以通過萬用字元進行篩選
$ composer show monolog/*

# 顯示具體某個包的資訊
$ composer show monolog/monolog

基本約束

精確版本

我們可以告訴 Composer 安裝的具體版本,例如:1.0.2,指定 1.0.2 版本。

範圍

通過使用比較操作符來指定包的範圍。這些操作符包括:>,>=,<,<=,!=。

你可以定義多個範圍,使用空格或者逗號 , 表示邏輯上的與,使用雙豎線 || 表示邏輯上的或。其中與的優先順序會大於或。 例項:

  • >=1.0
  • >=1.0 <2.0
  • >=1.0 <1.1 || >=1.2

我們也可以通過使用連字元 - 來指定版本範圍。

連字元的左邊表明了 >= 的版本,如果右邊的版本不是完整的版本號,則會被使用萬用字元進行補全。例如1.0 - 2.0等同於>=1.0.0 <2.12.0相當於2.0.*),而1.0.0 - 2.1.0則等同於>=1.0.0 <=2.1.0

萬用字元

可以使用萬用字元來設定版本。1.0.*相當於>=1.0 <1.1
例子:1.0.*

波浪號 ~

我們先通過後面這個例子去解釋~操作符的用法:~1.2相當於>=1.2 <2.0.0,而~1.2.3相當於>=1.2.3 <1.3.0。對於使用Semantic Versioning作為版本號標準的專案來說,這種版本約束方式很實用。例如~1.2定義了最小的小版本號,然後你可以升級2.0以下的任何版本而不會出問題,因為按照Semantic Versioning的版本定義,小版本的升級不應該有相容性的問題。簡單來說,~定義了最小的版本,並且允許版本的最後一位版本號進行升級(沒懂得話,請再看一邊前面的例子)。
例子:~1.2

需要注意的是,如果~作用在主版本號上,例如~1,按照上面的說法,Composer可以安裝版本1以後的主版本,但是事實上是~1會被當作~1.0對待,只能增加小版本,不能增加主版本。

折音號 ^

^操作符的行為跟Semantic Versioning有比較大的關聯,它允許升級版本到安全的版本。例如,^1.2.3相當於>=1.2.3 <2.0.0,因為在2.0版本前的版本應該都沒有相容性的問題。而對於1.0之前的版本,這種約束方式也考慮到了安全問題,例如^0.3會被當作>=0.3.0 <0.4.0對待。
例子:^1.2.3


版本穩定性

如果你沒有顯式的指定版本的穩定性,Composer會根據使用的操作符,預設在內部指定為-dev或者-stable。例如:

約束 內部約束
1.2.3 =1.2.3.0-stable
>1.2 >1.2.0.0-stable
>=1.2 >=1.2.0.0-dev
>=1.2-stable >=1.2.0.0-stable
<1.3 <1.3.0.0-dev
<=1.3 <=1.3.0.0-stable
1 - 2 >=1.0.0.0-dev <3.0.0.0-dev
~1.3 >=1.3.0.0-dev <2.0.0.0-dev
1.4.* >=1.4.0.0-dev <1.5.0.0-dev

例子:1.0 - 2.0

如果你想指定版本只要穩定版本,你可以在版本後面新增字尾-stable

minimum-stability 配置項定義了包在選擇版本時對穩定性的選擇的預設行為。預設是stable。它的值如下(按照穩定性排序):devalphabetaRCstable。除了修改這個配置去修改這個預設行為,我們還可以通過穩定性標識(例如@stable@dev)來安裝一個相比於預設配置不同穩定性的版本。例如:

{
    "require": {
        "monolog/monolog": "1.0.*@beta",
        "acme/foo": "@dev"
    }
}