> For the complete documentation index, see [llms.txt](https://bwtit.gitbook.io/phpdev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bwtit.gitbook.io/phpdev/ban-ben-guan-kong/duan-zhi-ling-github.md).
# 遠端指令與GitHub
若要和其他人分享專案，就必須將本地端儲存庫的特定版本，推(push)到遠端儲存庫整併，下一次要開發專案時，應先從遠端儲存庫將新版程式碼 fetch 回本地端儲存庫，再從本地端儲存庫 checkout 回工作目錄中，或是直接 pull 回工作目錄。
### 推送(push)資料至遠端儲存庫
遠端儲存庫也可以自行架設，例如使用 [GitLab Community Edition](https://gitlab.com/gitlab-org/gitlab-ce) ，但在此我們推薦直接使用 GitHub 進行免費的原始碼代管服務，以減少學習的複雜度，GitHub 延伸的線上服務還有可儲存程式碼片段的 [Gist](https://gist.github.com/)、 可撰寫手冊等電子書的 [GitBook](https://www.gitbook.com/) 等，都是很值得運用的好工具。
請先在 GitHub 建立名為 demo 的遠端儲存庫
預設使用 https 作為推送方式
#### 設定遠端 repo 的 url
執行以下指令後，會將遠端儲存庫的名稱與 url 儲存在專案設定檔 .git/config
```
git remote add origin https://github.com/自己的帳號/demo.git
```
> 若要更改推送方式為 ssh ，則要執行 `git remote rm origin` 重設遠端儲存庫的 url，否則會發生錯誤 fatal: remote origin already exists
#### 查詢遠端 repo 設定
執行以下指令後，可觀察目前遠端 repo 設定
```
git remote -v
```
#### 推送 local repo 至 remote repo
執行以下指令後，將本地端儲存庫 master 分支(預設分支)推送到遠端儲存庫 origin
```
git push -u origin master
```
> -u 參數是讓 git 將分支名稱記錄在專案設定檔 .git/config，下次就可以直接使用 git push 指令推出去了
>
> 從第一次 commit 開始，Git 就會建立預設分支，其名稱固定叫 master
>
> 實際的作用原理為將本地端的 master branch 與遠端的 master branch 作 fast-forward 合併。如果出現 \[rejected] 錯誤的話，表示你必須先作 pull
### 從遠端儲存庫將專案複製(clone)回來
當不存在專案的本地端儲存庫時，執行 git clone 指令可把專案在遠端儲存庫上的所有內容複製到本地，建立起本機儲存庫與工作目錄，通常用於參考遠端儲存庫某專案的程式碼時使用。
```
mkdir testcd testgit clone https://github.com/自己的帳號/demo.git
```
### 從遠端儲存庫將專案拉(pull)回來
已存在專案的本地端儲存庫時，執行以下指令後，會將專案的最新版本從遠端儲存庫拉回來並合併分支，通常用於協同開發時更新之用。
```
git pull origin master
```
> 實際是先 git fetch 遠端的 branch，然後與本地端的 branch 做 merge，產生一個 merge commit 節點
## 參考網頁
* [ ] [Push 上傳到 GitHub](https://gitbook.tw/chapters/github/push-to-github.html)
* [ ] [Pull 下載更新](https://gitbook.tw/chapters/github/pull-from-github.html)