# Apache Eylemcilerinin Kullanımı

Bu belgede Apache Eylemcilerinin kullanımı açıklanmıştır.

# Eylemci Nedir?

mod_actions
mod_asis
mod_cgi
mod_imagemap
mod_info
mod_mime
mod_negotiation
mod_status
Action
AddHandler
RemoveHandler
SetHandler

Bir eylemci bir dosya çağrıldığında uygulanacak eylemin Apache dahilindeki gösterimidir. Genellikle dosyaların kendi türüne bağlı olarak örtük eylemcileri vardır. Normalde tüm dosyalar basitçe sunucu tarafından sunulurlar, fakat bazı dosya türleri normalden farklı şekilde ele alınırlar.

Eylemciler, dosya türünden bağımsız olarak dosyanın bulunduğu yere veya dosya ismi uzantısına göre de yapılandırılabilirler. Gerek, zarif bir çözüm oluşuyla gerekse, hem dosya türünü hem de bir dosya ile ilişkili bir eylemciyi mümkün kılması sebebiyle bunun getirisi daha yüksektir. (Ayrıca, çok uzantılı dosyalara da bakınız.)

Eylemciler sunucu içinde derlenebileceği gibi bir modül olarak ya da Action yönergesi ile de sunucuya dahil edilebilirler. Standart dağıtımda bulunan yerleşik eylemciler şunlardır:

- default-handler: Dosyayı, öntanımlı olarak durağan içeriği işlemekte kullanılan `default_handler()` işlevini kullanarak gönderir. (core)
- send-as-is: Dosyayı HTTP başlıklarıyla olduğu gibi gönderir. (mod_asis)
- cgi-script: Dosyayı bir CGI betiği olarak ele alır. (mod_cgi)
- imap-file: Dosyayı bir resim eşleme kuralları dosyası olarak çözümler. (mod_imagemap)
- server-info: Sunucunun yapılandırma bilgisini döndürür. (mod_info)
- server-status: Sunucunun durum raporunu döndürür. (mod_status)
- type-map: Dosyayı içerik uzlaşımı için bir tür eşlem dosyası olarak çözümler. (mod_negotiation)

# Örnekler

## Bir CGI betiği kullanarak durağan içeriğin değiştirilmesi

Aşağıdaki yönergeler sayesinde, `html` uzantılı dosyalar için yapılan istekler `footer.pl` CGI betiğininin çalıştırılmasına sebep olacaktır.

Action add-footer /cgi-bin/footer.pl
AddHandler add-footer .html

Bu yapılandırmayla, istenen belgenin özgün haliyle mi (yeri `PATH_TRANSLATED` ortam değişkenindedir) yoksa istenen değişiklikler veya eklemeler yapıldıktan sonra mı gönderileceğinden CGI betiği sorumlu olacaktır.

## HTTP başlıklı dosyalar

Aşağıdaki yönergeler kendi HTTP başlıklarını içeren dosyalar için kullanılan `send-as-is` eylemcisini etkinleştirmek amacıyla kullanılmıştır. `/siteler/htdocs/asis/` dizinindeki tüm dosyalar dosya ismi uzantılarına bakılmaksızın `send-as-is` eylemcisi tarafından işleme sokulacaktır.

<Directory /siteler/htdocs/asis>
SetHandler send-as-is
</Directory>

# Yazılım Geliştirenler İçin

Eylemci özellikleri gerçeklenirken kullanılmak üzere Apache API’ye bir ekleme yapılmıştır. Özellikle de, `request_rec` yapısına yeni bir kayıt eklenmiştir:

char *handler

Modülünüzün bir eylemciyi devreye sokmasını isterseniz, tek yapacağınız isteğin `invoke_handler` aşamasının hemen öncesinde `r->handler` alanına eylemcinin ismini atamak olacaktır. Eylemciler daha önce de bahsedildiği gibi bir içerik türü yerine bir eylemci ismi kullanılarak gerçeklenirler. Çok gerekli olmamakla birlikte, eylemciler için kullanılan adlandırma uzlaşımları gereğince, ismi oluşturan sözcükler, ortam türü isim alanını ihlal etmemek amacıyla bölü imleri ile değil tire imleri ile ayrılırlar.