之前說了很多關於 Nginx 模塊的內容，還有一部分非常重要的內容，那就是 Nginx 的變量。變量在 Nginx 中可以說無處不在，認識了解這些變量的作用和原理同樣是必要的，下面幾乎囊括了關於 Nginx 的所有變量，單獨看起來可能比較枯燥，放心，後面依然有實戰內容。

Nginx 變量的運行原理

圍繞 Nginx 中的變量模塊可以分為兩類，一類是提供變量的模塊，另外一類是使用變量的模塊。

• 提供變量的模塊
  • 在 Preconfiguration 源代碼中定義變量名以及可以解析出變量的方法
• 使用變量的模塊
  • 解析 nginx.conf 時定義變量的使用方式

也就是在 Nginx 啟動時，已經定義了變量，而只有當真正處理請求的時候，才會根據 nginx.conf 解析出來的變量使用方式調用 Preconfiguration 中定義的方法來實際獲取值。

這也是變量的兩個特性：

• 惰性求值：只有使用的時候才會去調方法解析
• 變量值可以時刻變化，其值為使用的那一時刻的值。例如發送響應包體字節數，實際在發送的過程中是一直在變化的。

除了 Nginx 的模塊之外，Nginx 框架也包含許多的變量，這些變量不需要通過編譯模塊來引入，而且，Nginx 框架所提供的變量往往反映了處理請求的細節，因此，了解 Nginx 框架所提供的變量是十分有必要的。

HTTP 請求相關的變量

先來看一下關於 HTTP 請求的相關變量。

• arg_參數名：URL 中某個具體參數的值

• query_string：與 args 變量完全相同

• args：全部 URL 參數

• is_args：如果請求 URL 中有參數則返回 ?，否則返回空

• content_length：HTTP 請求中標識包體長度的 Content-Length 頭部的值。如果請求中沒有攜帶這個參數，那麼就取不到對應的值。

• content_type：標識請求包體類型的 Content-Type 頭部的值。同樣需要用戶請求中攜帶對應的參數。

• uri：請求的 URI（不同於 URL，不包括 ? 后的參數）

• document_uri：與 uri 完全相同。由於歷史原因而存在的。

• request_uri：請求的 URL（包括 URI 以及完整的參數）

• scheme：協議名，例如 HTTP 或者 HTTPS

• request_method：請求方法，例如 GET 或者 POST

• request_length：所有請求內容的大小，包括請求行、頭部、包體等

• remote_user：由 HTTP Basic Authentication 協議傳入的用戶名

• request_body_file：很多時候會將用戶請求的包體存放到文件中，這個變量就是臨時存放請求包體的文件

  • 如果包體非常小則不會存文件
  • client_body_in_file_only 指令強制所有包體存入文件，且可決定是否刪除

• request_body：請求中的包體，這個變量當且僅當使用反向代理，且設定用內存暫存包體時才有效

• request：原始的 URL 請求，含有方法與協議版本，例如 GET /?a=1&b=22 HTTP/1.1

• host

  • 先從請求行中獲取
  • 如果含有 Host 頭部，則用其值替換掉請求行中的主機名
  • 如果前兩者都取不到，則使用匹配上的 server_name

• http_頭部名字：返回一個具體請求頭部的值

  特殊變量，這些變量會做一些處理。

  • http_host
  • http_user_agent
  • http_referer
  • http_via
  • http_x_forwarded_for
  • http_cookie

  通用變量，除了以上的變量，都可以取到對應的值。

TCP 連接相關的變量

下面是關於 TCP 連接的變量。

• binary_remote_addr：客戶端地址的整形格式，對於 IPv4 是 4 字節，對於 IPv6 是 16 字節，所以在 limit_req 和 limit_conn 中通常可以用作 key （詳見：Nginx 處理 HTTP 請求的 11 個階段 中的 preaccess 階段）
• connection：遞增的連接序號
• connection_requests：當前連接上執行過的請求數，對 keepalive 連接有意義
• remote_addr：客戶端地址
• remote_port：客戶端端口
• proxy_protocol_addr：若使用了 proxy_protocol 協議，則返回協議中的地址，否則返回空
• proxy_protocol_port：若使用了 proxy_protocol 協議則返回協議中的端口，否則返回空
• server_addr：服務端地址
• server_port：服務器端端口
• TCP_INFO：TCP 內核層參數，包括 $tcpinfo_rtt, ​$tcpinfo_rttvar,​$tcpinfo_snd_cwnd, $tcpinfo_rcv_space
• server_protocol：服務器端協議，例如 HTTP/1.1

Nginx 處理請求過程中產生的變量

Nginx 處理 HTTP 請求的過程中也會產生很多變量。

• request_time：請求處理到現在的耗時，單位為秒，精確到毫秒
• server_name：匹配上請求的 server_name 值
• https：如果開啟了 TLS/SSL 則返回 on，否則返回空
• request_completion：若請求處理完則返回 OK，否則返回空
• request_id：以 16 進制輸出的請求表示 id，該 id 共含有 16 個字節，是隨機生成的
• request_filename：待訪問文件的完整路徑
• document_root：由 URI 和 root、alias 規則生成的文件夾路徑
• realpath_root：將 document_root 中的軟鏈接等換成真實路徑
• limit_rate：返回客戶端響應時的速度上限，單位為每秒字節數。可以通過 set 指令修改對請求產生的效果

發送 HTTP 響應時相關的變量

• body_bytes_sent：響應中 body 包體的長度

• bytes_sent：全部 http 響應的長度

• status：http 響應中的返回碼

• sent_trailer_名字：把響應結尾內容里的值返回

• sent_http_頭部名字：響應中某個具體頭部的值

  特殊處理，下面這些變量需要經過特殊處理：

  • sent_http_content_type
  • sent_http_content_length
  • sent_http_location
  • sent_http_last_modified
  • sent_http_connection
  • sent_http_keep_alive
  • sent_http_transfer_encoding
  • sent_http_cache_control
  • sent_http_link

  通用：除了上面這些頭部，其他的頭部都是通用型的，也就是可以直接拿來用。

Nginx 系統變量

• time_local：以本地時間標準輸出的當前時間，例如 14/Nov/2018:15:55:37 +0800
• time_iso8601：使用 ISO8601 標準輸出的當前時間，例如 2018-11-14T15:55:37+08:00
• nginx_version：Nginx 版本號
• pid：所屬 worker 進程的進程 id
• pipe：使用了管道則返回 p，否則返回 .
• hostname：所在服務器的主機名，與 hostname 命令輸出一致
• msec：1970 年 1 月 1 日到現在的時間，單位為秒，小數點后精確到毫秒

實戰

配置文件：

log_format  vartest  '$remote_addr - $remote_user [$time_local] "$request" '
                      '$status bytes_sent=$bytes_sent body_bytes_sent=$body_bytes_sent "$http_referer" '
                      '"$http_user_agent" "$sent_http_abc"';

server {
	server_name var.ziyang.com localhost;
	#error_log logs/myerror.log debug;
	access_log logs/vartest.log vartest;
	listen 9090;
	
	location / {
		set $limit_rate 10k;
        # return 200; tcpinfo: $tcpinfo_rtt,$tcpinfo_rttvar, $tcpinfo_snd_cwnd, $tcpinfo_rcv_space 
		return 200 '
arg_a: $arg_a,arg_b: $arg_b,args: $args
connection: $connection,connection_requests: $connection_requests
cookie_a: $cookie_a
uri: $uri,document_uri: $document_uri, request_uri: $request_uri
request: $request
request_id: $request_id
server: $server_addr,$server_name,$server_port,$server_protocol
            
host: $host,server_name: $server_name,http_host: $http_host
limit_rate: $limit_rate
hostname: $hostname
content_length: $content_length
status: $status
body_bytes_sent: $body_bytes_sent,bytes_sent: $bytes_sent
time: $request_time,$msec,$time_iso8601,$time_local
';
	}	
}

從上面這個配置文件中，我們可以看出來，返回的響應裡面包含了一系列的變量，實際驗證一下：

  test_nginx curl -H 'Content-Length: 0' -H 'Cookie: a=c1' 'localhost:9090?a=1&b=22'

arg_a: 1,arg_b: 22,args: a=1&b=22
connection: 2,connection_requests: 1
cookie_a: c1
uri: /,document_uri: /, request_uri: /?a=1&b=22
request: GET /?a=1&b=22 HTTP/1.1
request_id: 5d40b1ff29d2b87d5db5c4f95ebf5e4d
server: 127.0.0.1,var.ziyang.com,9090,HTTP/1.1
host: localhost,server_name: var.ziyang.com,http_host: localhost:9090
limit_rate: 10240
hostname: yuanzizhen.local
content_length: 0
status: 200
body_bytes_sent: 0,bytes_sent: 0
time: 0.000,1590842354.866,2020-05-30T20:39:14+08:00,30/May/2020:20:39:14 +0800

大家可以對比一下響應和配置文件中的值是不是一一對應的，更加深刻的理解一下變量的含義。

好了，這一節咱們學習了。關於 Nginx 的變量就講完了，下一節講一下實際應用變量的兩個模塊，大家會有更深刻的理解。

本文首發於我的個人博客：iziyang.github.io，所有配置文件我已經放在了 Nginx 配置文件，大家可以自取。

本站聲明:網站內容來源於博客園,如有侵權,請聯繫我們,我們將及時處理

【其他文章推薦】

※網頁設計一頭霧水該從何著手呢? 台北網頁設計公司幫您輕鬆架站!

※網頁設計公司推薦不同的風格，搶佔消費者視覺第一線

※想知道購買電動車哪裡補助最多?台中電動車補助資訊懶人包彙整

※南投搬家公司費用,距離,噸數怎麼算?達人教你簡易估價知識!

※教你寫出一流的銷售文案?

※超省錢租車方案

最近被Boos調去給新人做培訓去了，目前把自己整理的一些東西分享出來，希望對大家有所幫助

demo源代碼地址：https://github.com/BM-laoli/BMlaoli-learn-VueRouter

本章節為VueRouter前端 路由的章節部分

大綱

一、基本概念

路由就是通過網絡把訊息從源地址傳輸到目的地的活動
需要一些映射表

1. 做路由
2. 做信息的轉發（核心就是：轉發）

後端路由還有前端路由，後端渲染和前端渲染

前端渲染（前後端分離API生態），後端渲染（view嵌套一起）

前端路由的核心概念
地址變化的時候改變url的時候，不進行整體頁面刷新

改變url但是不刷新頁面，的解決方式

我們有這樣的一個需求，改變url跳轉地址，我們獲取新的頁面，但是不希望頁面發生刷新

解決方案1：locaion.hash = ‘/’

這個是vueRouter的底層實現

監聽hash的變化，從而改變網頁數據的獲取機制，渲染對應的組件，

解決方案2：H5的histroray模式

1. pushState
   history.pushState({},”,’home’),第三個參數就是url

這裏的push實際上就是一個棧結構（先進后出），

假設我們這裏需要回去,使用back()彈棧

history.pushState({},'','home'),
history.pushState({},'','about'),
history.pushState({},'','user'),

//執行這個之後就能進行back()出棧了
history.back(),
// 此時的url是 /about

1. repalceState

這裡有一個方法和push方法很像，但是不會back()不能點擊後腿按鈕

history.repalceState({},'','user'),

1. go

這裏的go是對棧的一個操作，
go(-1)彈出一個
go(-2)彈出二個

go(1)壓入一個
go(2)壓入二個

go(-1)

以上就是我們的基本的前端路由原理

二、v-router基本使用

前端三大框架都有自己的router，可以用來構建SPA應用

使用小提示，還是非常非常的簡單的：

1. 如果你沒有安裝就需要 npm install vue-router去安裝
2. • 導入路由對象，並且調用Vue.use(VueRouter)安裝這個路由插件
   • 創建路由實例，傳入映射配置wxain
   • 在vue實例中掛載創建好了的路由

1.導入路由對象，並且配置optionn給路由

/router/index.js

/**
 * 配置路由相關的信息
 */
// 1. 導入
 import Router from 'vue-router'
 
 // 2.1 導入vue實例
import Vue from 'vue'

// 導入組件
import Home from '../components/Home.vue'
import About from '../components/About.vue'


// 2.2使用路由（插件），安裝插件，vue的插件，都是這樣安裝，Vue.use
Vue.use(Router)

// 3. 創建路路由對象，這個就是在Router裏面配置映射和對象等東西

// 4. 抽離配置項出來
const routes = []

const router = new Router({routes})

//4. 導出
export default router 
 

2.配置路由映射

/router/index.js

const routes = [
 
 {path:'/home',component:Home},
 {path:'/about',component:About},

] 

3.在實例中使用路由

/main.js

import Vue from 'vue'
import App from './App'
import router from './router'//注意啊模塊查找規則index.js

Vue.config.productionTip = false

/* eslint-disable no-new */
new Vue({
  el: '#app',
  router,// 主要是在這裏掛載進去就好了
  render: h => h(App)
}) 

4.小心，我們的路由入口還有連接link

/App.vue

<template>
  <div id="app">
    <!-- //這兩個是一個全局祖冊過着個組件，這個就是一個a標籤 -->
    <router-link to='/home'>首頁</router-link>
    <router-link to='/about'>關於</router-link>
    <!-- 路由出口,既：渲染的出口，這個就是一個佔位符號 -->
    <router-view></router-view>
  </div>
</template>

以下是我們的兩個組件

/Home.vue

<template>
    <div>
        <h2>我是首頁</h2>
        <p>我是首頁內容哈哈哈</p>
    </div>
</template>

<script>
    export default {
        
    }
</script>

<style scoped>

</style>

/About.vue

<template>
    <div>
        <h2>我是關於頁面</h2>
        <p>我是首關於內容哈哈哈</p>
    </div>
</template>

<script>
    export default {
        
    }
</script>

<style>

</style>

以上就是我們非常簡單的使用

三、其它的知識點補充

路由的默認值，並且修改成mode=>hisary模式

我們希望默認显示的就是一個首頁
解決方式，映射一個’/’，然後進行重定向
/index.js

  {
    path:'/',
    redirect:'/home'
  },

我們為什麼要去做這調整成一個history，因為我們希望去掉#這個標識

只需要在new 的時候指定一下就好了
/index,js

const router = new Router({
  routes,
  mode:"history"//就是這裏的這個更改路由方式
})

router-link的屬性

1. tage
   to是一個屬性 ，默認是渲染成一個a鏈接，假設我現在需要默認渲染成一個buttmm怎麼辦呢？
   加一個tag就好了

    <router-link to='/home' tag='button'  >首頁</router-link>

1. 更改模式replceStats 不允許瀏覽器回退
   replace加上去就好了

<router-link to='/about' tag='button' replace >關於</router-link>

1. 我們可以利用一些默認的東西去非常方便的做到想要的效果

<style>
.router-link-active{
  color: blue;
}
</style>

替換值：我們希望不要怎麼長，我們希望.active就能改樣式怎麼搞?
加一個active-calss就好了，這個直接就是acitve做為類就好了

 <router-link to='/home' tag='button'  active-class  >首頁</router-link>
 <style>
    .active{
        bgc:red
    }
 </style>

代碼路由跳轉，意思就是重定向

注意啊！route != router
在我們學習路由的時候，this.$router是一個非常重要的對象

這個東西在開中經常的使用

// this.$router.push('重定向的值就好了')。
// this.$router.push('/home')
// 如果你不想有出現回退按鈕，這樣來做就好了
this.$router.replace('/home')

四、動態路由參數

這裏只是簡單的介紹了理由傳參的地址欄拼接模式，但是還有更多更奇奇怪怪的傳值方式，詳見官方Router文檔,

this.$router.parmas
// 這個parmas裏面就是我們的路由參數存放點

這裏我們有這樣的一個需求，我們希望點擊user頁面的時候可以，得到任意的路由參數

比如我們現在/user/zhnsang，的時候可以獲取zhangshang，/user/lishi的時候可以獲取lishi>

1. 首先我們需要在路由裏面加:
   /router/index.js

   {
        path: "/user/:usermsg",
        component: User
    }
]

1. 頁面傳遞數據
   /App.vue

router-link :to="'/user/'+username">用戶相關</router-link>
<!-- 路由出口,既：渲染的出口，這個就是一個佔位符號 -->
<router-view></router-view>
  </div>
</template>

<script>
export default {
  name: 'App',
  data() {
    return {
      username: 'lisi'
    }
  },

1. 頁面獲取數據

一定要注意了，一定是rouer裏面定義的才能從另一路由拿出來

/User.vue

<template>
    <div>
        <h2>我是用戶相關專業</h2>
        <p>我是用戶訊息相關頁面，嘿嘿嘿嘿嘿</p>
        <h1>{{ $route.params.usermsg }}44</h1>
        <hr>
        <h2>{{username}}</h2>
    </div>
</template>

<script>
    export default {    
        computed: {
            username() {
                return this.$route.params.usermsg
            }
        },
    }
</script>

<style scpoe>

</style>

五、細節詳解

注意啊！再說一遍route != router

注意啊，這裏的$route實際上是我們在main裏面new的一個Router得到的,
並且 這個route對象是隨着請求的地方不一樣，而改變的。也就是說，這個的route是當前頁面中的route對象，而且在vue只能只有一個route實例存在

六、 Vue的webpack打包詳解 + 路由懶加載

一個vue項目的簡單打包目錄結構分析

我們來看看,在一個vue項目中，簡單的三個文件是怎麼打包的

假設目前有這樣的三個文件 ，我們需要對他們進行打包，mian是入口，有一個add業務，有一個math依賴模塊。那麼我們webpack打包成的三個文件到底是如何運行的呢？

在vue中 使用webpack打包的時候，會把一些東西給分模塊的打包出來，它打包的東西的目錄結構如下
裏面我們實際打包的時候會把css，js都給分開，各自有各自的作用

| dist
| ---static
| ---css
| ---js
| -----app.XXXX.js         (這個是項目的業務邏輯所在)
| -----manifest.xxxx.js    (這個是底層打包的依賴文件所在)
| -----vendor.xxxx.js      (這個是依賴所在)
| idnex.html

路由懶加載

1. 概念的理解

目前呢，我們打包的情況是這樣的：我們所有的代碼都是集中放在了以一個app.xxx.js文件中，這樣其實不利於後期的維護和開發，因為如果我們有很多很多的大量的代碼的時候，我們的這個文件就會變得非常非常的大，於是呢，我們就需要路由懶加載，所謂懶加載就是：‘在需要的時候，才去加載某個資源文件’，路由懶加載，就是把每一個路由對應的業務邏輯代碼，在打包的時候分割到不同的js文件中，如何在需要用的時候再去請求它

經過這樣的打包的懶加載之後，我們的目錄會變成這個樣子

| dist
| ---static
| ---css
| ---js
| -----0.xxx.js            (假設是路由home的業務邏輯代碼)
| -----1.xxx.js             (假設是路由about的業務邏輯代碼)
| -----app.XXXX.js         (這個是項目的業務邏輯所在)
| -----manifest.xxxx.js    (這個是底層打包的依賴文件所在)
| -----vendor.xxxx.js      (這個是依賴所在)
| idnex.html

1. 如何使用

使用非常的簡單，主要有如下的三種方式去使用,但是我最喜歡的還是最後一種方式
/rouetr/index.js

- 使用vue的異步組價和webpack的寫法，早期的時候
const Home = resolve =>{ require.ensure(['../compenet/Home.vue'],()=>{
   resolve (require('../compenet/Home.vue'))
})}

- AMD規範的寫法
const About = resolve =>{ require(['../compenent/About.vue'],resolve) }


- ES6的結合異步組件的方式（最常用）
const Home = () => import('../compenet/Home.vue')

實際的使用
/router/index.js

/**
 * 配置路由相關的信息
 */
// 1. 導入
import Router from 'vue-router'

// 2.1 導入vue實例
import Vue from 'vue'

// 導入組件
// import Home from '../components/Home.vue'
// import About from '../components/About.vue'
// import User from '../components/User'
const Home = () =>
    import ('../components/Home.vue')
const About = () =>
    import ('../components/About.vue')
const User = () =>
    import ('../components/User')


// 2.2使用路由（插件），安裝插件，vue的插件，都是這樣安裝，Vue.use
Vue.use(Router)

// 3. 創建路路由對象，這個就是在Router裏面配置映射和對象等東西

// 4. 抽離配置項出來
const routes = [{
        path: '/',
        redirect: '/home'
    },
    {
        path: '/home',
        component: Home
    },
    {
        path: '/about',
        component: About
    },
    {
        path: "/user/:usermsg",
        component: User
    }
]

const router = new Router({
    routes,
    mode: "history"
})

//4. 導出
export default router

//6. 去main裏面掛載

七、 路由嵌套

我們目前有這樣的一個需求：我們希望我們在hone下，可以/home/new去到home下的一個子組件，/home/message去到另一個子組件

1. 首先 我們需要有組件
   /components/HomeMessage.vue

<template>
    <div>
      <ul>
          <li1>我是消息1</li1>
          <li2>我是消息2</li2>
          <li3>我是消息3</li3>
          <li4>我是消息4</li4>
      </ul>
    </div>
</template>

<script>
    export default {
        name:"HomeMessage"
    }   
</script>

<style>

</style>

/components/HomeNews

<template>
    <div>
    <ul>
        <li1>新1</li1>
        <li2>新2</li2>
        <li3>新3</li3>
        <li4>新4</li4>
        <li5>新5</li5>
    </ul>
    </div>
</template>

<script>
    export default {
        name:"HomeNews"
    }
</script>

<style>

</style>

1. 在路由裏面去配置

const HomeNews = () =>
    import ('../components/HomeNews')
const HomeMessage = () =>
    import ('../components/HomeNews')


// 2.2使用路由（插件），安裝插件，vue的插件，都是這樣安裝，Vue.use
Vue.use(Router)

// 3. 創建路路由對象，這個就是在Router裏面配置映射和對象等東西

// 4. 抽離配置項出來
const routes = [{
        path: '/',
        redirect: '/home'
    },
    {
        path: '/home',
        component: Home,
        children: [{
                path: '',
                redirect: 'news'
            },
            {
                path: 'news',// 這裏寫路由實際上應該是/home/news,這裏只是一個相對路由地址，
                component: HomeNews
            },
            {
                path: 'message',
                component: HomeMessage
            },

        ]
    },
    {

1. 打入口router-view（瞎起的名字實際上就是路由的佔位符）
   /Home.vue

<template>
    <div>
        <h2>我是首頁</h2>
        <p>我是首頁內容哈哈哈</p>
     <router-link to="/home/news">news</router-link>
     <router-link to="/home/message">message</router-link>
    <router-view></router-view>
    </div>
</template>

<script>
    export default {
        
    }
</script>

<style scoped>

</style>

這裏如果是有關狀態的保持，我們需要使用key-alive,後面我們再做詳細的講解

本站聲明:網站內容來源於博客園,如有侵權,請聯繫我們,我們將及時處理

【其他文章推薦】

※網頁設計公司推薦不同的風格，搶佔消費者視覺第一線

※廣告預算用在刀口上，台北網頁設計公司幫您達到更多曝光效益

※自行創業缺乏曝光? 網頁設計幫您第一時間規劃公司的形象門面

※南投搬家公司費用需注意的眉眉角角，別等搬了再說!

※教你寫出一流的銷售文案?

• ver：1.0
• 博客：https://www.cnblogs.com/Rohn
• 本文介紹了Shell編程的一些語法規範，主要參考依據為谷歌的Shell語法風格。

目錄

• 背景
  • 使用哪一種Shell
  • 什麼時候使用Shell
• 註釋
  • 頂層註釋
  • 功能註釋
  • TODO註釋
• 格式
  • 縮進
  • 行的長度和長字符串
  • 管道
  • 循環
    • if-else語句
    • for-do和while-do語句
  • case語句
  • 變量擴展
• 特性
  • 命令替換
  • 文件名的通配符擴展
• 命名約定
  • 函數名
  • 變量名
  • 常量和環境變量名
  • 源文件名
  • 只讀變量
  • 使用本地變量
• 調用命令
  • 檢查返回值

背景

博客：https://www.cnblogs.com/Rohn

使用哪一種Shell

可執行文件必須以 #!/bin/bash 和最小數量的標誌開始。請使用 set 來設置shell的選項，使得用 <script_name>調用你的腳本時不會破壞其功能。

推薦使用：

#!/usr/bin/env bash

env一般固定在/usr/bin目錄下，而其餘解釋器的安裝位置就相對不那麼固定。

限制所有的可執行Shell腳本為bash使得我們安裝在所有計算機中的shell語言保持一致性。

無論你是為什麼而編碼，對此唯一例外的是當你被迫時可以不這麼做的。其中一個例子是Solaris SVR4包，編寫任何腳本都需要用純Bourne shell。

[root@test ~]# echo $SHELL
/bin/bash

什麼時候使用Shell

使用Shell需要遵守的一些準則：

• 如果你主要是在調用其他的工具並且做一些相對很小數據量的操作，那麼使用Shell來完成任務是一種可接受的選擇。
• 如果你在乎性能，那麼請選擇其他工具，而不是使用Shell。
• 如果你發現你需要使用數據而不是變量賦值（如 ${PHPESTATUS} ），那麼你應該使用Python腳本。
• 如果你將要編寫的腳本會超過100行，那麼你可能應該使用Python來編寫，而不是Shell。

請記住，當腳本行數增加，儘早使用另外一種語言重寫你的腳本，以避免之後花更多的時間來重寫。

註釋

博客：https://www.cnblogs.com/Rohn

Bash只支持單行註釋，使用#開頭的都被當作註釋語句。

頂層註釋

每個文件必須包含一個頂層註釋，對其內容進行簡要概述。版權聲明和作者信息是可選的。
例如：

#!/usr/bin/env bash
# Author: Rohn
# Version: 1.0
# Created Time: 2020/06/06
# Perform hot backups of MySQL databases.

• 第1行，指明解釋器，使用bash

#!叫做”Shebang”或者”Sha-bang”(Unix術語中，#號通常稱為sharp，hash或mesh；而!則常常稱為bang)，指明了執行這個腳本文件的解釋程序。當然，如果使用bash test.sh這樣的命令來執行腳本，那麼#!這一行將會被忽略掉。

• 第2-5行，分別為作者、版本號、創建時間、功能說明。

功能註釋

任何不是既明顯又短的函數都必須被註釋。任何庫函數無論其長短和複雜性都必須被註釋。

其他人通過閱讀註釋（和幫助信息，如果有的話）就能夠學會如何使用你的程序或庫函數，而不需要閱讀代碼。

所有的函數註釋應該包含：

• 函數的描述
• 全局變量的使用和修改
• 使用的參數說明
• 返回值，而不是上一條命令運行后默認的退出狀態

例如：

#!/usr/bin/env bash
# Author: Rohn
# Version: 1.0
# Created Time: 2020/06/06
# Perform hot backups of Oracle databases.

export PATH='/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/root/bin'

#######################################
# Cleanup files from the backup dir
# Globals:
#   BACKUP_DIR
#   ORACLE_SID
# Arguments:
#   None
# Returns:
#   None
#######################################
cleanup() {
  ...
}

TODO註釋

TODOs應該包含全部大寫的字符串TODO，接着是括號中你的用戶名。冒號是可選的。最好在TODO條目之後加上bug或者ticket的序號。

例如：

# TODO(mrmonkey): Handle the unlikely edge cases (bug ####)

格式

博客：https://www.cnblogs.com/Rohn

縮進

縮進兩個空格，沒有製表符。例如：

if [ a > 1 ];then
  echo '${a} > 1'
fi

行的長度和長字符串

行的最大長度為80個字符。例如：

# DO use 'here document's
cat <<END;
I am an exceptionally long
string.
END

# Embedded newlines are ok too
long_string="I am an exceptionally
  long string."

管道

如果一行容不下整個管道操作，那麼請將整個管道操作分割成每行一個管段。

應該將整個管道操作分割成每行一個管段，管道操作的下一部分應該將管道符放在新行並且縮進2個空格。這適用於使用管道符|的合併命令鏈以及使用||和&&的邏輯運算鏈。

例如：

# All fits on one line
command1 | command2

# Long commands
command1 \
  | command2 \
  | command3 \
  | command4

循環

if-else語句

if和; then放在同一行，;后空一格，else單獨一行，fi單獨一行，並與if垂直對齊。即：

if condition; then
  statement(s)
else
  statement(s)
fi

for-do和while-do語句

while/for和; do放在同一行，done與while/for垂直對齊，即：

# while structure
while condition; do
  statement(s)
done

# for structure
for condition; do
  statement(s)
done

例如：

for dir in ${dirs_to_cleanup}; do
  if [[ -d "${dir}/${ORACLE_SID}" ]]; then
    log_date "Cleaning up old files in ${dir}/${ORACLE_SID}"
    rm "${dir}/${ORACLE_SID}/"*
    if [[ "$?" -ne 0 ]]; then
      error_message
    fi
  else
    mkdir -p "${dir}/${ORACLE_SID}"
    if [[ "$?" -ne 0 ]]; then
      error_message
    fi
  fi
done

case語句

• 通過2個空格縮進可選項。
• 在同一行可選項的模式右圓括號之後和結束符 ;;之前各需要一個空格。
• 長可選項或者多命令可選項應該被拆分成多行，模式、操作和結束符;;在不同的行。

匹配表達式比case和esac 縮進一級。多行操作要再縮進一級。一般情況下，不需要引用匹配表達式。模式表達式前面不應該出現左括號。避免使用;&和;;&符號。即：

# case structure
case in expression in
  pattern1)
    statement1
    ;;
  pattern2)
    statement2
    ;;
  ...
  *)
    statementn
    ;;
esac

例如：

case "${expression}" in
  a)
    variable="..."
    some_command "${variable}" "${other_expr}" ...
    ;;
  absolute)
    actions="relative"
    another_command "${actions}" "${other_expr}" ...
    ;;
  *)
    error "Unexpected expression '${expression}'"
    ;;
esac

只要整個表達式可讀，簡單的命令可以跟模式和;; 寫在同一行。這通常適用於單字母選項的處理。當單行容不下操作時，請將模式單獨放一行，然後是操作，最後結束符;; 也單獨一行。當操作在同一行時，模式的右括號之後和結束符;;之前請使用一個空格分隔。

verbose='false'
aflag=''
bflag=''
files=''
while getopts 'abf:v' flag; do
  case "${flag}" in
    a) aflag='true' ;;
    b) bflag='true' ;;
    f) files="${OPTARG}" ;;
    v) verbose='true' ;;
    *) error "Unexpected option ${flag}" ;;
  esac
done

變量擴展

按優先級順序：保持跟你所發現的一致；引用你的變量；推薦用${var}而不是$var 。

例如

# Section of recommended cases.

# Preferred style for 'special' variables:
echo "Positional: $1" "$5" "$3"
echo "Specials: !=$!, -=$-, _=$_. ?=$?, #=$# *=$* @=$@ \$=$$ ..."

# Braces necessary:
echo "many parameters: ${10}"

# Braces avoiding confusion:
# Output is "a0b0c0"
set -- a b c
echo "${1}0${2}0${3}0"

# Preferred style for other variables:
echo "PATH=${PATH}, PWD=${PWD}, mine=${some_var}"
while read f; do
  echo "file=${f}"
done < <(ls -l /tmp)

# Section of discouraged cases

# Unquoted vars, unbraced vars, brace-quoted single letter
# shell specials.
echo a=$avar "b=$bvar" "PID=${$}" "${1}"

# Confusing use: this is expanded as "${1}0${2}0${3}0",
# not "${10}${20}${30}
set -- a b c
echo "$10$20$30"

特性

博客：https://www.cnblogs.com/Rohn

命令替換

使用 $(command)而不是反引號。

嵌套的反引號要求用反斜杠轉義內部的反引號。而$(command) 形式嵌套時不需要改變，而且更易於閱讀。

例如：

# This is preferred:
var="$(command "$(command1)")"

# This is not:
var="`command \`command1\``"

文件名的通配符擴展

當進行文件名的通配符擴展時，請使用明確的路徑。

因為文件名可能以-開頭，所以使用擴展通配符./*比*來得安全得多。

# Here's the contents of the directory:
# -f  -r  somedir  somefile

# This deletes almost everything in the directory by force
psa@bilby$ rm -v *
removed directory: `somedir'
removed `somefile'

# As opposed to:
psa@bilby$ rm -v ./*
removed `./-f'
removed `./-r'
rm: cannot remove `./somedir': Is a directory
removed `./somefile'

命名約定

博客：https://www.cnblogs.com/Rohn

函數名

使用小寫字母，並用下劃線分隔單詞。使用雙冒號 :: 分隔庫。函數名之後必須有圓括號。關鍵詞 function 是可選的，但必須在一個項目中保持一致。

如果你正在寫單個函數，請用小寫字母來命名，並用下劃線分隔單詞。如果你正在寫一個包，使用雙冒號 :: 來分隔包名。大括號必須和函數名位於同一行（就像在Google的其他語言一樣），並且函數名和圓括號之間沒有空格。

# Single function
my_func() {
  ...
}

# Part of a package
mypackage::my_func() {
  ...
}

當函數名后存在 () 時，關鍵詞 function 是多餘的。但是其促進了函數的快速辨識。

變量名

使用小寫字母，循環的變量名應該和循環的任何變量同樣命名。例如：

for zone in ${zones}; do
  something_with "${zone}"
done

常量和環境變量名

全部使用大寫字母，用下劃線分隔，聲明在文件的頂部。例如：

# Constant
readonly PATH_TO_FILES='/some/path'

# Both constant and environment
declare -xr ORACLE_SID='PROD'

源文件名

使用小寫字母，如果需要的話使用下劃線分隔單詞。例如： maketemplate 或者 make_template ，而不是 make-template 。

只讀變量

使用小寫字母，使用 readonly 或者 declare -r 來確保變量只讀。

因為全局變量在Shell中廣泛使用，所以在使用它們的過程中捕獲錯誤是很重要的。當你聲明了一個變量，希望其只讀，那麼請明確指出。

zip_version="$(dpkg --status zip | grep Version: | cut -d ' ' -f 2)"
if [[ -z "${zip_version}" ]]; then
  error_message
else
  readonly zip_version
fi

使用本地變量

使用小寫字母，使用 local 聲明特定功能的變量。聲明和賦值應該在不同行。

使用 local 來聲明局部變量以確保其只在函數內部和子函數中可見。這避免了污染全局命名空間和不經意間設置可能具有函數之外重要性的變量。

當賦值的值由命令替換提供時，聲明和賦值必須分開。因為內建的 local 不會從命令替換中傳遞退出碼。

my_func2() {
  local name="$1"

  # Separate lines for declaration and assignment:
  local my_var
  my_var="$(my_func)" || return

  # DO NOT do this: $? contains the exit code of 'local', not my_func
  local my_var="$(my_func)"
  [[ $? -eq 0 ]] || return

  ...
}

調用命令

博客：https://www.cnblogs.com/Rohn

檢查返回值

對於非管道命令，使用$?或直接通過一個if語句來檢查以保持其簡潔。例如：

if ! mv "${file_list}" "${dest_dir}/" ; then
  echo "Unable to move ${file_list} to ${dest_dir}" >&2
  exit "${E_BAD_MOVE}"
fi

# Or
mv "${file_list}" "${dest_dir}/"
if [[ "$?" -ne 0 ]]; then
  echo "Unable to move ${file_list} to ${dest_dir}" >&2
  exit "${E_BAD_MOVE}"
fi

Bash也有 PIPESTATUS 變量，允許檢查從管道所有部分返回的代碼。如果僅僅需要檢查整個管道是成功還是失敗，以下的方法是可以接受的：

tar -cf - ./* | ( cd "${dir}" && tar -xf - )
if [[ "${PIPESTATUS[0]}" -ne 0 || "${PIPESTATUS[1]}" -ne 0 ]]; then
  echo "Unable to tar files to ${dir}" >&2
fi

可是，只要你運行任何其他命令， PIPESTATUS 將會被覆蓋。如果你需要基於管道中發生的錯誤執行不同的操作，那麼你需要在運行命令后立即將 PIPESTATUS 賦值給另一個變量（別忘了 [ 是一個會將 PIPESTATUS 擦除的命令）。

tar -cf - ./* | ( cd "${DIR}" && tar -xf - )
return_codes=(${PIPESTATUS[*]})
if [[ "${return_codes[0]}" -ne 0 ]]; then
  do_something
fi
if [[ "${return_codes[1]}" -ne 0 ]]; then
  do_something_else
fi

本站聲明:網站內容來源於博客園,如有侵權,請聯繫我們,我們將及時處理

【其他文章推薦】

※別再煩惱如何寫文案,掌握八大原則!

※網頁設計一頭霧水該從何著手呢? 台北網頁設計公司幫您輕鬆架站!

※超省錢租車方案

※教你寫出一流的銷售文案?

※網頁設計最專業,超強功能平台可客製化

※產品缺大量曝光嗎?你需要的是一流包裝設計!

環境資訊中心綜合外電；姜唯 編譯；林大利 審校

本站聲明:網站內容來源環境資訊中心https://e-info.org.tw/,如有侵權,請聯繫我們,我們將及時處理

【其他文章推薦】

※網頁設計一頭霧水該從何著手呢? 台北網頁設計公司幫您輕鬆架站!

※網頁設計公司推薦不同的風格，搶佔消費者視覺第一線

※想知道購買電動車哪裡補助最多?台中電動車補助資訊懶人包彙整

※南投搬家公司費用,距離,噸數怎麼算?達人教你簡易估價知識!

※教你寫出一流的銷售文案?

※超省錢租車方案

摘錄自2020年9月17日中央社報導

波蘭動物皮草農場主人和猶太潔食肉品製造業者今（16日）在首都華沙抗議一項正在國會闖關的新法，這項法案受到動物維權團體支持。

法新社報導，根據動物維權人士說法，波蘭是全球第3大皮草生產國，僅次於中國和丹麥，此外，波蘭也是將猶太潔食肉品外銷到以色列和歐洲猶太社區的重要出口國。

這項立法將禁止業者透過畜養動物來獲取皮草，並禁止出口按伊斯蘭教律法及猶太律法處理的肉品。

這項立法上週首度遭到擱置時，執政法律正義黨黨魁卡臣斯基（Jaroslaw Kaczynski）表示：「波蘭對於動物的標準應該不比西方國家差，甚至應該更好。」

生物多樣性
國際新聞
波蘭
動物皮草
立法

本站聲明:網站內容來源環境資訊中心https://e-info.org.tw/,如有侵權,請聯繫我們,我們將及時處理

【其他文章推薦】

※網頁設計一頭霧水該從何著手呢? 台北網頁設計公司幫您輕鬆架站!

※網頁設計公司推薦不同的風格，搶佔消費者視覺第一線

※Google地圖已可更新顯示潭子電動車充電站設置地點!!

※廣告預算用在刀口上，台北網頁設計公司幫您達到更多曝光效益

※別再煩惱如何寫文案,掌握八大原則!

※網頁設計最專業,超強功能平台可客製化