27.15. 製作 libpq 程序

要製作（也就是說編譯和鏈接）您的 libpq 程序，您需要做下面的一些事情：

• 包含 libpq-fe.h 頭文件︰

  #include <libpq-fe.h>

  如果您沒幹這件事，那麼您通常會看到類似下面這樣的來自編譯器的訊息︰

  foo.c: In function `main':
  foo.c:34: `PGconn' undeclared (first use in this function)
  foo.c:35: `PGresult' undeclared (first use in this function)
  foo.c:54: `CONNECTION_BAD' undeclared (first use in this function)
  foo.c:68: `PGRES_COMMAND_OK' undeclared (first use in this function)
  foo.c:95: `PGRES_TUPLES_OK' undeclared (first use in this function)

• 告訴您的編譯器PostgreSQL頭文件的安裝位置， 方法是給您的編譯器提供 -Idirectory 選項。 (有些時候編譯器會查找預設的目錄，因此您可以忽略這些選項。) 比如，您的命令行看起來像︰

  cc -c -I/usr/local/pgsql/include testprog.c

  如果您在使用製作文件(makefile)，那麼向 CPPFLAGS 變量中增加下面的選項︰

  CPPFLAGS += -I/usr/local/pgsql/include

  如果您的程序可能會被別人編譯，那麼您應該避免象上面那樣把目錄路徑 寫成硬編碼。取而代之的是您可以執行 pg_config 工具找出頭文件在系統的什麼地方︰

  $ pg_config --includedir
  /usr/local/include

  如果沒能給編譯器提供正確的選項將產生類似下面這樣的錯誤訊息

  testlibpq.c:8:22: libpq-fe.h: No such file or directory

• 在鏈接最後的程序的時候，聲明選項 -lpq， 這樣就可以把 libpq 庫鏈接進來， 還要聲明 -Ldirectory 以告訴編譯器 libpq 所處的目錄。 (同樣，編譯器也會搜索一些預設的目錄。) 為了盡可能提高可移植性，您應該把 -L 選項放在 -lpq 選項前面。比如︰

  cc -o testprog testprog1.o testprog2.o -L/usr/local/pgsql/lib -lpq

  您也可以用 pg_config 找出庫目錄︰

  $ pg_config --libdir
  /usr/local/pgsql/lib

  指向這類問題的錯誤訊息會是類似下面這個樣子。

  testlibpq.o: In function `main':
  testlibpq.o(.text+0x60): undefined reference to `PQsetdbLogin'
  testlibpq.o(.text+0x71): undefined reference to `PQstatus'
  testlibpq.o(.text+0xa4): undefined reference to `PQerrorMessage'

  這意味著您忘記 -lpq 了。

  /usr/bin/ld: cannot find -lpq

  這意味著您忘記這-L 或者沒有聲明正確的目錄。

如果您的代碼引用了頭文件 libpq-int.h， 而且您不原意修補您的代碼以避免使用它，那麼從 PostgreSQL7.2 開始， 該文件將在 includedir/postgresql/internal/libpq-int.h 裡出現， 因此您需要給您的編譯器命令行增加合適的 -I 選項。