将nginx编译成静态库

库是一种软件组件技术，库里面封装了数据和函数。


库的使用可以使程序模块化。
Windows系统包括静态链接库（.lib文件）和动态链接库（.dll文件）。
Linux通常把库文件存放在/usr/lib或/lib目录下。
Linux库文件名由：前缀lib、库名和后缀3部分组成，其中动态链接库以.so最为后缀，静态链接库通常以.a作为后缀。
在程序中使用使用静态库和动态库时，他们载入的顺序是不同的。
静态库的代码在编译时就拷贝的应用程序中，这样的优点是节省编译时间。
动态链接库时程序在开始运行后调用库函数时才被载入。


静态库的创建和使用：
1、在一个头文件种声明静态库所导出的函数。
2、在一个源文件种实现静态库所导出的函数。
3、编译源文件，生成可执行代码。
4、将可执行代码所在的目标文件加入到某个静态库中，并将静态库拷贝到系统默认的存放库文件的目录下。
下面通过一个例子来说明：mylib.h种存放的是静态库提供给用户使用的函数的声明，mylib.c实现了mylib.h种声明的函数。


头文件：mylib.h
#ifndef _MYLIB_H_
#define _MYLIB_H_
 
void weclome(void);
void outString(const char *str);
 
#endif
源文件：mylib.c


#include "mylib.h"
#include 
 
void welcome(void)
{
    printf("welcome to libmylib\n");
}
 
void outString(const char *str)
{
    if(str != NULL)
        printf("%s\n", str);
}
1>编译mylib.c生成目标文件：gcc -o mylib.o -c mylib.c


2>将目标文件加入到静态库中：ar rcs libmylib.a mylib.o
3>将静态库copy到Linux的库目录（/usr/lib或者/lib）下：
cp libmylib.a /usr/lib/libmylib.a 
编写调用库函数的测试程序test.c:
#include "mylib.h"
#include 
 
int main(void)
{
    printf("create and use library:\n");
    welcome();
    outString("it's successful\n");
 
    return 0;
}
4>使用静态库编译：gcc -o test test.c -lmylib


这里注意,编译时无需带上前缀和后缀。
5>运行可执行程序test: ./test
create and use library:
welcome to libmylib
it's successful
在Linxu下，可以使用ar命令来创建和修改静态库。


这些在linux下man ar一下就可以得到参数，这里说明几个常用的
d:从库中删除成员文件。
r:在库中加入成员文件，若存在，则替换。
c:创建一个库。
s:无论ar命令是否修改了库内容，都强制重新生成库符号表。
其他的命令用时再man。


上面这五步是基本的使用，还有需要的话，就要深入的学习了。

实践：将nginx编译为静态库：

(1)将nginx的main函数重定义为ngx_main
(2)\定义ngx_sgs.h头文件，将需要开放的函数和相关数据结构包含进来
(3)编译nginx
(4)将目标文件加入静态库
ar rcs libnginx.a objs/*.o objs/src/core/*.o objs/src/event/*.o objs/src/event/modules/*.o objs/src/os/unix/*.o objs/src/sgs/*.o
(5)将生成的静态库和相关文件拷贝进系统目录和产品目录
cp libnginx.a /usr/lib/libnginx.a
cp src/sgs/ngx_sgs.h /usr/lib/ngx_sgs.h
cp conf/nginx.conf /usr/lib/nginx.conf
cp libnginx.a /usr/local/src/test/libnginx.a
cp src/sgs/ngx_sgs.h /usr/local/src/test/ngx_sgs.h
cp conf/nginx.conf /usr/local/src/test/nginx.conf
(6)在产品中调用开放接口
(7)编译产品，注意因为nginx依赖-lpthread，因此在编译时要加入该库
  gcc -o test test.c -lnginx -lpthread
(7)运行产品
   ./test