configure
betiği, Apache HTTP Sunucusunun kaynak kodlarını
belli bir platform için yapılandırmakta ve derlemekte kullanılır.
Sunucuyu kişisel gereksinimlerinize uygun şekilde derlemek için çeşitli
seçeneklere sahiptir.
Bu betik Apache HTTP Sunucusu kaynak paketinin kök dizininde bulunur ve sadece Unix ve benzeri sistemlerde kullanılabilir. Kaynak paketinin diğer platformalarda yapılandırılması ve derlenmesi hakkında bilgi edinmek için platform belgelerine bakınız.
configure
betiğini kaynak paketinin kök dizininden başka
bir yere kopyalayıp çalıştırmamalısınız.
./configure [seçenek]...
[değişken=değer]...
CC
, CFLAGS
gibi ortam değişkenlerini
değişken=değer
atamaları biçiminde
kullanabilirsiniz. Kullanışlı değişkenlerin bazıları aşağıda açıklanmıştır.
Aşağıdaki seçenekler configure
betiğinin kendi davranışını
belirlemekte kullanılır.
-C
--config-cache
--cache-file=config.cache
için bir kısaltmadır.--cache-file=dosya
dosya
dosyasında saklanır.
Bu seçenek açıkça belirtilmedikçe işlevsizdir.-h
--help [short|recursive]
short
değeriyle sadece
bu pakete özgü seçenekler listelenir. recursive
değeriyle
ise paketin içindeki tüm paketler için kısa bir yardım metni
basılır.-n
--no-create
configure
betiği normal olarak çalışır fakat herhangi
bir çıktı dosyası üretmez. Derleme için Makefile
dosyalarını üretmeksizin sınamaların sonuçlarını görmek için
yararlıdır.-q
--quiet
checking ...
iletilerini basmaz.
--srcdir=dizin
dizin
dizinini kaynak dosyaları dizini olarak
tanımlar. configure
betiğinin bulunduğu dizin veya bir
üst dizin öntanımlıdır.--silent
--quiet
ile aynı.Bu seçenekler kurulum dizinlerini tanımlar. Kurulum dizinleri seçilmiş yerleşime bağımlıdır.
--prefix=PREFIX
PREFIX
dizininin
altına kurulur. /usr/local/apache2
öntanımlı kurulum
dizinidir.--exec-prefix=EPREFIX
EPREFIX
dizininin
altına kurulur. Bunun için PREFIX
dizini
öntanımlı kurulum dizinidir.Öntanımlı olarak, make install
tüm dosyaların
/usr/local/apache2/bin
, /usr/local/apache2/lib
gibi dizinlere kurulmasını sağlar. Kurulum dizini önekini örneğin,
--prefix=$HOME
şeklinde belirterek kurulumun başka bir yere
yapılmasını sağlayabilirsiniz.
--enable-layout=LAYOUT
LAYOUT
yerleşimine dayalı olduğu varsayımıyla
yapılandırılır. Bu seçenek sayesinde Apache HTTP Sunucusu kurulumu
içinde her dosya türü için farklı bir yer belirleyebilirsiniz.
config.layout
dosyasında böyle yapılandırma örnekleri
vardır. Örnekleri izleyerek kendi yapılandırmanızı
oluşturabilirsiniz. Bu dosyada örneğin FOO
isimli
yerleşim <Layout FOO>...</Layout>
bölümü
içinde düzenlenmiştir ve her yerleşim için böyle ayrı bir bölüm
vardır. Öntanımlı yerleşim Apache
’dir.Kurulum dizinlerini daha iyi denetim altında tutmak için aşağıdaki
seçenekler kullanılır. Lütfen, dizin öntanımlılarının
autoconf
tarafından tanımlandığına ve seçilen yerleşim
ayarlarının bunları yerini aldığına dikkat ediniz.
--bindir=dizin
dizin
dizinine kurulur. Bunlar
EPREFIX/bin
dizinine kurulur.--datadir=dizin
dizin
dizinine kurulur. Bunların öntanımlı kurulum dizini
PREFIX/share
dizinidir. Bu seçenek
autoconf
tarafından atanır ve şimdilik
kullanılmamıştır.--includedir=dizin
dizin
dizinine kurulur.
Bunların öntanımlı kurulum dizini
PREFIX/include
dizinidir.--infodir=dizin
dizin
dizinine kurulur.
Bunların öntanımlı kurulum dizini
PREFIX/info
dizinidir. Bu seçenek şimdilik
kullanılmamıştır.--libdir=dizin
dizin
dizinine
kurulur. Bunların öntanımlı kurulum dizini
PREFIX/lib
dizinidir.--libexecdir=dizin
dizin
dizinine kurulur. Öntanımlı olarak
libexecdir
bu dizini
EPREFIX/modules
olarak tanımlar.--localstatedir=dizin
dizin
dizinine kurulur. Öntanımlı olarak localstatedir
bu
dizini PREFIX/var
olarak tanımlar. Bu
seçenek autoconf
tarafından atanır ve şimdilik
kullanılmamıştır.--mandir=dizin
dizin
dizinine kurulur.
Öntanımlı olarak mandir
bu dizini
EPREFIX/man
olarak tanımlar.--oldincludedir=dizin
dizin
dizinine
kurulur. Öntanımlı olarak oldincludedir
bu dizini
/usr/include
olarak tanımlar. Bu seçenek
autoconf
tarafından atanır ve şimdilik
kullanılmamıştır.--sbindir=dizin
dizin
dizinine kurulur. Bunlar
sbindir
bu
dizini EPREFIX/sbin
olarak tanımlar.--sharedstatedir=dizin
dizin
dizinine kurulur. Öntanımlı olarak
sharedstatedir
bu dizini
PREFIX/com
olarak tanımlar. Bu seçenek
autoconf
tarafından atanır ve şimdilik
kullanılmamıştır.--sysconfdir=dizin
httpd.conf
, mime.types
gibi tek
makinelik salt okunur sunucu yapılandırma dosyaları
dizin
dizinine kurulur. Öntanımlı olarak
sysconfdir
bu dizini
PREFIX/conf
olarak tanımlar.Bu seçenekleri Apache HTTP Sunucusunu başka bir platformda çalıştırmak üzere çapraz derleme yaparken kullanılır. Normal durumlarda sunucu derlendiği platformda çalıştırıldığından bu seçenekler kullanılmaz.
--build=derleme-ortamı
config.guess
betiği ile elde edilen sonuç
öntanımlıdır.--host=çalışma-ortamı
derleme-ortamı
’dır.--target=hedef-ortam
hedef-ortam
sistem türü için
yapılandırır. Öntanımlı sistem türü
çalışma-ortamı
’dır. Bu seçenek
autoconf
tarafından atanır ve Apache HTTP Sunucusu için
gerekli değildir.Bu seçenekler HTTP sunucunuzun sahip olmasını istediğiniz özelliklerin hassas olarak ayarlanmasını sağlar.
Bir özelliği etkin kılmak veya iptal etmek için genellikle şu sözdizimi kullanılır:
--disable-özellik
özellik
özelliğine sahip olmaz. Bu
seçenek--enable-özellik=no
seçeneğine
eşdeğerdir.--enable-özellik[=değer]
özellik
özelliğine sahip olur.
değer
belirtilmediği takdirde
yes
(evet) öntanımlıdır.--enable-modül=shared
--enable-modül=static
--enable-filanca
seçeneğinin varlığı
configure
betiğinin filanca
diye
bir modül var olmasa bile bundan şikayetçi olmasına sebep olmaz. Bu
bakımdan dikkatli olunuz.
Modüllerin çoğu öntanımlı olarak derlenir ve ya açıkça iptal edilmek
ya da few
veya none
anahtar sözcükleri
kullanılarak kaldırılmak zorunda kalınır (ayrıntılar için
--enable-modules
, --enable-mods-shared
ve
--enable-mods-static
seçeneklerine bakın).
Öntanımlı olarak derlenmeyenler ise ya açıkça etkin kılınmak ya da
all
veya reallyall
anahtar sözcükleriyle
kullanılabilir yapılmak zorunda kalınır.
Hangi modüllerin öntanımlı olarak derlendiğini öğrenmek için
./configure -h
veya ./configure --help
komutunu çalıştırın ve çıktıdaki Optional Features
bölümüne bakın. Örnek olarak,
Optional Features: ... --disable-example1 example module 1 --enable-example2 example module 2 ...
Burada, mod_example1
öntanımlı olarak etkindir ve
derlenmemesini istiyorsanız --disable-example1
seçeneğini kullanmalısınız. mod_example2
ise öntanımlı
olarak derlenmemektedir ve derlenmesini istiyorsanız
--enable-example2
seçeneğini kullanmalısınız.
Çok Süreçlilik Modülleri veya MPM'ler sunucunun temel davranışını belirler. Sunucuya yüklenebilecek azami MPM sayısı birdir. Kullanılabilecek modüller modül dizininde listelenmiştir.
MPM'ler devingen yükleme için DSO olarak derlenebileceği gibi sunucuyla duruk olarak da ilintilenebilir ve bunlar aşağıdaki seçeneklerle etkin kılınır:
--with-mpm=MPM
Sunucu için öntanımlı MPM'i seçer. MPM'ler DSO modülleri olarak
derleniyorsa (bak --enable-mpms-shared
), bu seçenek
öntanımlı yapılandırma dosyasında yüklenecek MPM'i seçer. Aksi
takdirde, sunucuyla duruk olarak ilintilenecek, kullanılabilir tek
MPM'i seçer.
Bu seçenek belirtilmezse, işletim sisteminiz için öntanımlı olan MPM seçilir.
--enable-mpms-shared=MPM-LISTESİ
MPM'leri devingen paylaşımlı modül olarak etkinleştirir.
MPM-LISTESİ MPM'lerin aralarına boşluk bırakılarak ve tamamı tek tırnaklarla sarmalanarak oluşturulmuş bir listesidir. Örnek:
Ek olarak, kullandığınız platformda devingen yüklemeyi destekleyen
ve DSO modülü olarak derlenmiş tüm modülleri seçmek için
all
anahtar sözcüğünü de kullanabilirsiniz. Örnek:
Üçüncü parti modülleri etkin kılmak için şu seçenekler kullanılır:
--with-module=modül-türü:modül-dosyası[,modül-türü:modül-dosyası]
Durağan ilintili modüller listesine belirtilen modülleri ekler.
Modül kaynak dosyası modül-dosyası
, önce
Apache HTTP Sunucusu kaynak ağacı altında
modules/modül-türü
alt dizininde aranır.
Modül orada değilse configure
betiği
modül-dosyası
ile bir mutlak dosya yolu
belirtildiği varsayımıyla kaynak dosyasını
modül-türü
alt dizinine kopyalamaya çalışır.
Alt dizin mevcut değilse oluşturulur ve içine standart bir
Makefile.in
yerleştirilir.
Bu seçenek tek kaynak dosyasından oluşan küçük harici modülleri eklemek için yararlıdır. Daha karmaşık modüller için modül üreticisi tarafından sağlanan belgelere bakınız.
Durağan ilintili modüller yerine bir DSO modülü derlemek
isterseniz
--enable-maintainer-mode
--enable-mods-shared=modül-listesi
Etkinleştirilip devingen paylaşımlı modül olarak derlenecek
modüllerin listesi belirtilir. Yani, bu modüller
modül-listesi
tırnak içine alınmış boşluk
ayraçlı modül isimleri listesidir. Modül isimleri önlerindeki
mod_
öneki olmaksızın belirtilirler. Örnek:
modül-listesi
yerine
reallyall
, all
, most
,
few
ve none
anahtar sözcükleri de
belirtilebilir. Örneğin,
seçeneği ile çoğu modül DSO modülü olarak derlenir,
seçeneği ile sadece en temel modüller derlenir.
most
öntanımlıdır.
Seçilen modüller için --enable-foo
yapılandıma seçeneği ile açıkça seçilen modüller ve gerekli olanlar
dışında kalan LoadModule
yönergeleri açıklama haline
getirilir. Yüklü modülleri httpd.conf
dosyasındaki
--enable-load-all-modules
yapılandırma seçeneği ile de
etkinleştirilebilir.
Yetersizlikler:
--enable-mods-shared=all
aslında bütün modüllerin
derlenmesini sağlamaz. Tüm modülleri derlemek için şunu
yapabilirsiniz:
--enable-mods-static=modül-listesi
--enable-mods-shared
seçeneğine benzer. Yani bu
modüller --enable-modules=MODULE-LIST
--enable-mods-shared
gibi davranır ve ek
olarak belirtilen modülleri devingen olarak ilintiler.Özel
none
anahtar sözcüğü tüm modüllerin derlenmesini iptal
eder.--enable-v4-mapped
--with-port=port
httpd.conf
yapılandırma dosyası
üretilirken kullanılır. 80. port öntanımlıdır.--with-program-name
httpd
yerine başka bir çalıştırabilir
ismi tanımlar.Buradaki seçenekler seçimlik paketleri tanımlamak için kullanılır.
Bir seçimlik paketi tanımlamak için genellikle şöyle bir sözdizimi kullanılır:
--with-paket[=değer]
paket
paketi kullanılır. Öntanımlı
değer
yes
’tir.--without-paket
paket
paketi kullanılmaz. Öntanımlı
değer
no
’dur. Bu seçenek
autoconf
tarafından sağlanmıştır ve Apache HTTP
Sunucusu için pek yararlı değildir.--with-apr=dizin|dosya
configure
betiğine apr-config
betiğinin
yolunu belirterek ifade edebilirsiniz. Kurulu APR için bid dizin,
dosya ismi veya mutlak dosya yolu belirtebilirsiniz.
apr-config
ya belirttiğiniz dizinde ya da
bin
alt dizininde bulunmalıdır.--with-apr-util=dizin|dosya
configure
betiğine apu-config
betiğinin yolunu belirterek ifade
edebilirsiniz. Kurulu APR için bir dizin, dosya ismi veya mutlak
dosya yolu belirtebilirsiniz. apr-config
ya
belirttiğiniz dizinde ya da bin
alt dizininde
bulunmalıdır.--with-ssl=dizin
configure
betiği kurulu bir OpenSSL arayacaktır. Kendi SSL/TLS kurulumunuzun
yolunu bu seçenekle belirtebilirsiniz.--with-z=dizin
configure
betiği
kurulu zlib
kütüphanesinin yerini tespit etmeye
çalışacaktır. Kendi sıkıştırma kütüphanenizin yerini bu seçenekle
belirtebilirsiniz.Apache HTTP Sunucusunun çeşitli bölümleri,
--with-gdbm[=dizin-yolu]
dizin-yolu
belirtilmemişse
configure
betiği GNU DBM kurulumunun kütüphanelerini ve
başlık dosyalarını bulunması olası yerlerde arar. Bir
dizin-yolu
belirtilmişse
configure
betiği kurulumun kütüphanelerini
dizin-yolu/lib
altında, başlık dosyalarını
ise dizin-yolu/include
altında arayacaktır.
Bundan başka, başlık ve kütüphane dosyalarının bulundukları yerler
iki nokta imi ile ayrılarak dizin-yolu
olarak belirtilebilir.--with-ndbm[=dizin-yolu]
--with-gdbm
seçeneği gibidir.--with-berkeley-db[=dizin-yolu]
--with-gdbm
seçeneği gibidir.DBM seçenekleri APU tarafından sağlanmış olup onun yapılandırma
betiğine aktarılır. Bu seçenekler --with-apr-util
seçeneği ile tanımlanmış bir kurulu APU varsa kullanışlı olur.
HTTP sunucunuz ile birlikte birden fazla DBM gerçeklenimi kullanabilirsiniz. Kullanılacak DBM türünü her zaman çalışma anı yapılandırmanızla yapılandırabilirsiniz.
--enable-static-support
--enable-suexec
Tek bir destek programını aşağıdaki seçenekleri kullanarak bir durağan ilintili çalıştırılabilir olarak derleyebilirsiniz:
--enable-static-ab
--enable-static-checkgid
checkgid
programının durağan ilintili sürümü
derlenir.--enable-static-htdbm
--enable-static-htdigest
--enable-static-htpasswd
--enable-static-logresolve
--enable-static-rotatelogs
suexec
yapılandırma seçenekleriAşağıdaki seçeneklerle
--with-suexec-bin
--sbindir
ile belirtilen
dizine kurulur (Kurulum dizinlerinde
ince ayar konusuna bakınız).--with-suexec-caller
--with-suexec-docroot
--datadir/htdocs
öntanımlıdır.--with-suexec-gidmin
--with-suexec-logfile
suexec_log
olup
--logfiledir
seçeneği ile belirtilen dizin altında
bulunur.--with-suexec-safepath
PATH
ortam değişkenine tanımlamak için kullanılır.
/usr/local/bin:/usr/bin:/bin
öntanımlıdır.--with-suexec-userdir
public_html
alt dizini öntanımlıdır.--with-suexec-uidmin
--with-suexec-umask
umask
tanımlar. Sisteminiz için geçerli ayarlar
öntanımlıdır.configure
betiğinin yerleri ve isimleri standartlara uygun
olmayan kütüphaneleri ve programları bulmasını yardımcı olan veya
configure
betiği tarafından yapılan bazı seçimleri
değiştirmenizi sağlayacak bazı ortam değişkenleri vardır.
CC
CFLAGS
CPP
CPPFLAGS
includedir
dizinindeyse bunu
-Iincludedir
seçeneği olarak
belirtebilirsiniz.LDFLAGS
libdir
dizinindeyse bunu
-Llibdir
seçeneği olarak belirtebilirsiniz.