---
# System prepended metadata

title: 在win10安裝laravel10
tags: [laravel]

---

# 在win10安裝laravel10
## 方法一 : 使用wsl(不推薦)
laravel8後官方推薦方式，但wsl常常會碰到權限等問題，sudo、chmod都無法解決
### 建立虛擬機
1. 安裝 Windows Linux Subsystem
    控制台 → 程式集 → 程式與功能 → 開啟或關閉windows功能
    ![](https://hackmd.io/_uploads/rJA_vJYfT.png)
    勾選「windows子系統Lilnux版」
    ![](https://hackmd.io/_uploads/SkFiPyFMa.png)

2. 安裝Ubuntu
    開啟Miscrosoft Store
    ![](https://hackmd.io/_uploads/SJTeOktzp.png)
    搜尋ubuntu並安裝需要的版本
    ![](https://hackmd.io/_uploads/Sy6WuJYf6.png)
    設定使用者、密碼
    ![](https://hackmd.io/_uploads/SJDzd1tGT.png)

### Docker設定
1. Docker Destop安裝
    由此下載https://www.docker.com/products/docker-desktop/

2. 在設定中開啟ubuntu的wsl2
    ![](https://hackmd.io/_uploads/r1EzKJYfT.png)
    如果沒有看到ubuntu，開啟cmd檢查wsl版本
    ```bash=
    $ wsl -l -v
    ```
    ![](https://hackmd.io/_uploads/SJtOKyYz6.png)
    如果ubuntu版本是1，輸入指令更改
    ```bash=
    $ wsl --set-version
    ```
    開啟vscode終端機，選擇虛擬機版本
    ![](https://hackmd.io/_uploads/ryL12JYfp.png)
    檢查 
    ```bash= 
    $ docker ps
    ``` 
    ![](https://hackmd.io/_uploads/S1ob3ytM6.png)

### 建立laravel
官網 : https://docs.cornch.dev/zh-tw/laravel/10.x/installation#getting-started-on-windows
1. 在vscode終端機輸入指令
    ```bash=
    $ curl -s https://laravel.build/example-app | bash
    ```
    `example-app`為專案名稱

2. 建立完成後開啟專案資料夾的.env檔案，建立laravel專用的port，ubuntu預設http://localhost會導到Apache2
    ```bash=
    APP_PORT=3001 // or any number port you like
    ```

3. 完成後切到專案資料夾並啟動
    ```bash=
    $ cd example-app
    $ ./vendor/bin/sail up
    ```
    在瀏覽器網址輸入http://localhost:3001/檢查
    ![](https://hackmd.io/_uploads/rk-fnlFfT.png)

## 方法二 : 使用laradock
官網 : https://laradock.io/

在[這篇文章](https://learnku.com/articles/26850?order_by=vote_count&)中有說不能在win10家用版使用，故沒有嘗試
## 方法三 : xampp
### 安裝xampp或wamp
- xampp : https://www.apachefriends.org/zh_tw/index.html
- wamp : https://www.wampserver.com/en/

### 安裝php
laravel10需使用php8.1以上
如果有安裝wamp的話可以使用 `C:\wamp64\bin\php` 底下的php並設定於環境變數中
![](https://hackmd.io/_uploads/S1HlTgtMp.png)

### 安裝composer
官網 : https://getcomposer.org/，由此下載
安裝完成後，打開cmd輸入`composer -v` 檢查使否安裝成功
![](https://hackmd.io/_uploads/SJ8fTltzp.png)

### 安裝laravel10
打開cmd切到需要建立專案的資料夾，輸入以下指令
```bash=
$ laravel new laravel_test
```
`laravel_test`為專案名稱

打開cmd切到需要建立專案的資料夾，輸入以下指令，啟動xampp或wamp輸入http://localhost/
```bash=
$ php artisan serve
```
![](https://hackmd.io/_uploads/SyIAaxtfp.png)

### 其他問題
#### xampp phpMyadmin 404
參考 : https://www.youtube.com/watch?v=na4s3lwUAjA
1. 開啟Apache → config → Apache(httpd.conf)
    修改Listen，改成80port以外的port
    ![](https://hackmd.io/_uploads/rktP0xYGp.png)
    修改ServerName， localhost:port改成跟上面Listen一樣的port
    ![](https://hackmd.io/_uploads/SJ2OAgKGa.png)

2. 開啟Apache → config → Apache(httpd-ssl.conf)
    修改Listen，改成443port以外的port且不要與httpd.conf設定的相同
    ![](https://hackmd.io/_uploads/rkLjRxFfp.png)
    修改VirtualHost _default_， port改成跟上面Listen一樣的port
    ![](https://hackmd.io/_uploads/HkZ2RltMp.png)

3. 開啟config → Service and port Settings
    修改Main port與httpd.conf設定的port相同
    修改SSL port與httpd-ssl.conf設定的port相同
    ![](https://hackmd.io/_uploads/Hy4C0lFfp.png)
    如果碰到存取遭拒，關掉xampp並以系統管理員再次啟動並設定
    ![](https://hackmd.io/_uploads/HkBk1bKMa.png)

4. 開啟MySQL→ Admin檢查phpMyadming是否正常
    ![](https://hackmd.io/_uploads/SJubk-Fz6.png)

## 常用指令
- 更新laravel composer
    ```bash=
    $ composer update
    ```
- 確認Laravel版本
    ```bash=
    $ php artisan --version
    ```
- 執行laravel
    ```bash=
    $ php artisan serve
    ```
## 參考資料
https://laravel.com/docs/10.x/releases
https://www.docker.com/products/docker-desktop/
https://docs.cornch.dev/zh-tw/laravel/10.x/installation#getting-started-on-windows
https://laradock.io/
https://www.apachefriends.org/zh_tw/index.html
https://www.wampserver.com/en/
https://getcomposer.org/
https://www.youtube.com/watch?v=na4s3lwUAjA